| Google ツールバー API |
|
|
|
API メイン ページ API スタートガイド API ドキュメント 自作のボタンを ギャラリーに追加 ボタン ギャラリー |
Internet Explorer 用 Google ツールバー 4 にカスタム ボタンを作成する方法ここではカスタム ボタンを作成する方法を説明します。 現時点では、カスタム ボタンは Internet Explorer にのみ対応しています。目次カスタム ボタンとはカスタム ボタンはカスタム ナビゲーション、検索、送信、更新の機能を実行するボタンで、Google ツールバーに追加することができます。 カスタム検索ボタンは、Google だけでなく、ほとんどのウェブ サイトの検索エンジンで使用可能です。 検索ボタンをクリックすると次のような処理が実行されます。
カスタム ボタンは次のようなユーザー インターフェース機能を備えています。
上記のユーザー インターフェース機能のプロパティに加えて、カスタム ボタンには上記のタスクを実行する次のプロパティを XML ファイルとして備えています。
Slashdot、Wikipedia、および BBC (ハイライト表示) のカスタム ボタンのあるツールバーのサンプルは次をご覧ください。 BBC ボタンは、下向き矢印で表示されるニュース フィードの見出しのプルダウン リストです。
カスタム ボタンを追加するGoogle ツールバーでカスタム ボタンの追加または管理を行うには、次をご覧ください。
自動的にカスタム検索ボタンを作成し、追加する
カスタム ボタンがインストールされ、すぐに利用できるようになります。 この処理では、アイコンとカスタム ボタンの XML ファイルが生成され、次の場所にハッシュ化された名前で保存されます。:
この方法は複雑な POST リクエストやリダイレクトを使用するウェブ サイトで、 カスタム ボタンの XML ファイル
カスタム ボタンのプロパティと動作は、XML ファイルの
<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
<button>
<site>http://www.wikipedia.org</site>
</button>
</custombuttons>
注: XML ファイルの URL の文字列に改行や空白を含めても問題はありません。ツールバーがファイルを解読するときに削除されます。 反対に、URL に空白が必要な場合 (空白を削除しない場合) には、手動で "%20" に置き換えることが必要になります。 今後出てくる例の多くは URL が 2 行に分けて記述してあり、URL の中間には改行文字が挿入されていますが、動作にはまったく問題ありません。
注: このガイドに挙げられた例は共通して、
手動でカスタム ボタンを作成し、インストールするGoogle ツールバーにカスタム ボタンをインストールするには、次をご覧ください。
ボタン名とツールのヒントを追加する
次にあるように、ボタン名を追加するには
ツールのヒントを追加するには、
<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
<button>
<site>http://www.wikipedia.org</site>
<title>Wikipedia</title>
<description>The Free Encyclopedia</description>
</button>
</custombuttons>
カスタム検索ボタンGoogle ツールバーでは、ツールバーの検索ボックスに入力するテキストを使用してほとんどの検索エンジンで実行できるボタンを作成できます。 次に、Wikipedia 検索エンジンのを使って wikipedia.org を検索できるボタンと Google の検索エンジンを使ってインターネットを検索できるボタンの 2 つの例をご紹介します。
このように設定するには、ボタンの XML ファイルに 注: Wikipedia 検索のカスタム ボタン
Wikipedia の検索エンジンを使用して wikipedia.org を検索するボタンを作成するには、たとえば、"dog" のような最も単純な Wikipedia クエリから始めます。
<search>http://en.wikipedia.org/wiki/Special:Search?search=
この検索要素を既存のボタンに加えることで、次のようになります。
<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
<button>
<site>http://www.wikipedia.org</site>
<title>Wikipedia</title>
<description>The Free Encyclopedia</description>
<search>http://en.wikipedia.org/wiki/Special:Search?search=
URL のアンパサンド (&) が " Google 検索のカスタム ボタン
Goolge の検索エンジンを使用してインターネットを検索するボタンを作成するには、たとえば、"dog" のような最も単純な Google クエリから始めます。
<search>http://www.google.com/search?q={query}</search>
次に例を示します。 Slashdot 検索
<search>http://slashdot.org/search.pl?query={query}</search>
検索クエリを POST として送信する
検索クエリを GET ではなく、POST として送信するには、検索要素に The Onion 検索この例では、postdata (ハイライト表示) の送信に POST 方式を使用しています。 <search method="post">http://www.theonion.com/content/search/node ?edit%5Bkeys%5D={query}</search> カスタム ボタンを更新するボタンを定義する XML ファイルの置かれている URL が、ボタン固有の ID となり、ボタンの更新に必要となります。 同一の URL でダウンロードを繰り返しても、ツールバーでは古いボタンの置き換えのみが行われ、新しいボタンが追加されることはありません。
ボタンを追加する 5 つの方法のうち、最初の方法と最後の方法では更新が自動的に行われ、XML ファイルに記述された <update>http://buttons.com/updated_button.xml</update> ボタンのオプション
ボタンは
<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
<button>
<title>Weather</title>
<option>
<title>Zip code</title>
<description>Enter a US zip code. For example, 94043 is Mountain View, CA</description>
<default>94043</default>
</option>
<site>http://www.google.com/search?q=weather+{option1}</site>
</button>
</custombuttons>
option 内の title は必要ですが、default と description は必ずしも必要ではありません。 ユーザーのテキストを挿入するには、url テンプレートの定義内に変数 {option1} のを使用してください。 この時点では、入力の検証やホワイトスペースのトリミングを行う必要はありません。{option1} 変数は、フォーム送信のテキスト編集ボックスと同様に、utf-8 を使った入力や cgi パラメータをすべてエスケープします。 現在の URL を組み込む
検索クエリを送信する以外に、現在ブラウザに表示している URL を指定する方法が 3 つあります。:
archive.org にはエスケープしない URL が必要とされるため、次の例では、現在のページの古いバージョンを検索するために URL を archive.org に送信するのに
<site>http://web.archive.org/web/*/
次の例でも、同じ archive.org の検索を実行できます。
<site method="post">http://www.archive.org/searchresults.php?search=
現在のウェブ サイトで Google 検索エンジンを使う場合は、
<search>http://www.google.com/search?q=site:
Google ドメインのサフィックスを組み込む
Google ツールバーには、
ドメインの文字列は、ハードコーディングするのではなく、変数
<search>http://www.google.
ユーザーの選択したテキストを送信するウェブ ページでユーザーが選択したプレーン テキストを送信するようカスタム ボタンを設定することもできます。 この設定は、翻訳サービス、ブログやメッセージングの アプリケーションなどで役立ちます。 テキストが選択されると、カスタム ボタン アイコンに小さなテキスト アイコンが表示されます。
この操作には
<send>http://www.google.com/search?hl=en&lr=&q=define%3A+
送信操作を実行するカスタム ボタンは、テキストが選択されるとマウスの右クリックのコンテキスト メニューにも表示されます。 変数が存在するかどうかを確認する
ツールバーの拡張に伴い、挿入される URL 変数の数も増加します。 新しい変数との互換性を確保するために、次の {存在有無を確認するパラメーター?パラメーターがある場合に表示するテキスト:ない場合に表示するテキスト}
つまり、高度なカスタム ボタンの作成者が新しい機能を安全に利用でき、新しい機能を解析できないパーサーとの互換性を持たせることが可能になります。 たとえば、{locale} 変数が挿入されたとします。 このような URL テンプレートを使うと、古いバーションのツールバーには確実に影響を及ぼさないようにすることができます。 <site>http://www.google.com/{locale??hl={locale}}</site>
ツールバーが {locale} 変数をサポートしている場合には、次のように拡張します。 <site>http://www.google.com/?hl=en</site> 対応していない場合は、次のようになります。 <site>http://www.google.com/</site>
<site>http://www.google.com/{locale??hl={domain?{domain}:{query}}}</site>
エスケープ処理が認識されない場合には、パーサーは空白の文字列で置き換えます。 したがって、”Hell{blah}o World” は、”Hello World” と表示されます。 また、中かっこの ’{‘または ’}’ の数があわない場合や他の構文上の問題がある場合には、URL 全体が空白の文字列にリセットされます。 独自のアイコンを作成する方法ファビコンとして使用されているアイコンはほとんどの場合、カスタム ボタンのアイコンとして使用することができます。 これには 16×16 BMP、 ICO、GIF、および JPEG 画像が含まれます。 base64 エンコードを使用して ASCII テキストにエンコードしてください。 インターネットでは、エンコーディングを代行するサイトが幾つかあります。たとえば、こちらのサイトでは [Browse... (参照...)] ボタンでエンコードしたいファイルを選択し、[Convert the source data (データのソースを変換する)] ボタンをクリックするとエンコーディングを開始します。 Javascript と PHP にも base64 エンコードの 1 行コマンドがあります。
次は base64 の Gmail アイコンで、
<icon mode="base64" type="image/x-icon">
AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAQAQAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA4ONr/ODja/6en+f+np/n/p6f5/6en+f+np/n/p6f5
/6en+f+np/n/p6f5/6en+f+np/n/p6f5/zg42v84ONr/ODja/zg42v/i4v//////////////////
/////////////////////////////////////+Li//84ONr/ODja/zg42v84ONr/p6f5/+Li////
/////////////////////////////////////////+Li//+np/n/ODja/zg42v84ONr/ODja/+Li
//+np/n/4uL/////////////gYHy/4GB8v///////////+Li//+np/n/4uL//zg42v84ONr/ODja
/zg42v//////4uL//6en+f+2tv//gYHy/1pa6f9aWun/gYHy/7a2//+np/n/4uL///////84ONr/
ODja/zg42v84ONr///////////+2tv//gYHy/1pa6f84ONr/ODja/1pa6f+BgfL/trb/////////
////ODja/zg42v84ONr/ODja////////////gYHy/1pa6f84ONr/trb//7a2//84ONr/Wlrp/4GB
8v///////////zg42v84ONr/ODja/zg42v//////gYHy/1pa6f84ONr/trb/////////////trb/
/zg42v9aWun/gYHy//////84ONr/ODja/zg42v84ONr/gYHy/1pa6f84ONr/trb/////////////
//////////+2tv//ODja/1pa6f+BgfL/ODja/zg42v84ONr/ODja/zg42v84ONr/trb/////////
/////////////////////////7a2//84ONr/ODja/zg42v84ONr/ODja/zg42v84ONr/gYHy/6en
+f+np/n/p6f5/6en+f+np/n/p6f5/6en+f+np/n/gYHy/zg42v84ONr/ODja/wAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAA//8AAP//AAD//wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAD//wAA//8AAA==
</icon>
カスタム ボタン アイコンは 16×16 を超えた場合、ツールバーが自動的に 16×16 にリサイズしますので、大きな画像はご自身で高性能のイメージ エディタを使用してリサイズした場合と比べて見劣りしてしまいます。 最もきれいに見えるアイコンは 24 ビット カラー (RGB) と 8 ビットのアルファ チャネルを使用し、XP スタイル RGBA アイコンとして保存されているものです。アルファチャネルを設定して、16×16 の PNG 形式で保存し、IconWorkshop のようなプログラムで XP スタイル 16×16 アイコンに変換した後、base64 でエンコードします。 PNG ファイルは Windows が本来サポートしている形式ではないため、サポートしていません。 アルファ チャネルを使う必要があるのは、すべてのユーザーのツールバーの背景が(グレー、シルバー、ベージュなど)、お客様が設定した色であるとは限らないためです。 Windows XP では、ツールバーの背景色を含めた、カラースキームのカスタマイズが可能です。 透明色を使用せず、四角いアイコンを作成することもできますが、あまり魅力的ではありません。 GIF 画像のような単色のアルファ チャネルでは、Google ツールバーや Internet Explorer などのように、適切にアルファ ブレンドされたアイコンに比べて境界線が荒くなります。 アイコンやツールのヒントを自動更新するカスタム ボタンの機能の中に、定期的にリモートサーバーからボタンの画像やツールのヒントを自動更新できるというものがあります。 この更新には RSS フィードが使用されます。 RSS フィードによって、ボタンを通知デバイスや、天気予報などのステータス アイコンとして利用することができます。 また、テキストやアイコンの各種アイテムからなるプルダウン メニューを備えることもできます。 それぞれのメニュー アイテムには、クリックによって作動する動的 URL を含めることができます。 これらの例は次のセクションをご覧ください。 RSS フィードを追加する
RSS フィードでは <feed refresh-interval="1800">http://rss.cnn.com/rss/cnn_topstories.rss</feed> これらの更新フィードを取得するためのプロトコルは Atom 1.0、Atom 0.3、RSS 2.0、RSS 1.0 のいずれかになります。 通常のフィードであれば、問題なく動作します。 フィードを使用してボタン アイコンやツールのヒントを更新するツールバーのアイコンやツールのヒントの詳細をフィードから更新するには、RSS、または ATOM にネームスペースを使用してツールバーに固有の拡張記述を追加する必要があります。 フィードから取り込むムードリング ボタンの例は次のとおりです。 <?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
<button>
<title>Mood ring</title>
<description>Your virtual mood ring</description>
<site>http://www.google.com/search?q=mood+ring</site>
<feed menu="false" refresh-interval="900">
http://www.example.com/custombuttons/samples/feeds/mood</feed>
</button>
</custombuttons>
サブアイテムのプルダウン メニューを取り込むのではなく、アイコンとツールのヒントの更新のためだけにフィードが使われていることを表す これが実際のサーバーで設定されている場合、フィードの出力は次のようになります。 <?xml version='1.0'?>
<feed xmlns='http://www.w3.org/2005/Atom'
xmlns:gtb='http://toolbar.google.com/custombuttons/'>
<id>http://www.example.com/custombuttons/samples/feeds/mood</id>
<title>Mood</title>
<link href='http://www.google.com/search?q=+ring' />
<link rel='self'
href='http://www.example.com/custombuttons/samples/feeds/mood' />
<gtb:description>Bluegreen:
Inner emotions charged, somewhat relaxed</gtb:description>
<gtb:icon mode="base64" type="image/x-icon">
AAAAAAMAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAwAAAAMAA
AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAQAQAAAAAAAAAAAAAAAAA
AAAAAAAAAAAGAAAAHAAAAEAAAABhAAAAcwAAAHQAAABpAAAAVQAAAD4AAAApAAAAGAAAAAoAAAAD
AAAAAQAAAAAAAAAAAAAAESZIXl4zdJvAXbHS8m3C3f9LnrrLFUtsmwILEX4AAABzAAAAYQAAAEcA
AAAqAAAAEwAAAAcAAAACAAAAACs9RTNOjrDtW6nS/53u/f+n/P//hej//2bP/P9Fq93wHGaNrxEv
O4kAAAB6AAAAXwAAADwAAAAfAAAADAAAAANihaWST6XK/0h/kcAdKCyWKTtAgVJ/kIhytNKse873
9E+w6v9RuN39SXuJpgQHCIoAAAB2AAAAUQAAACsAAAAPb6nU7mK65v9jqs76KkNPqAUICJoAAACE
AAAAaxUgJWBkrMiwsvv+//D+/v+y1NniIj1FnAAAAIgAAABcAAAALHS74PV1zPn/c835/1Oezv9N
iq7vNVRjrxUiJ5kBAgORAQICh3uLjZz3+vr1+f///4PL5/wvVmusAAAAigAAAFNyu+TPdtL8/0Cp
7v8ng8X/CFOH/ytpjv86gJ//R46z+Th6jsovVmCsd56pxNf2/f9TuPH/W7fs/ypGV6UAAAByf77Y
r02y7P9Zwfb/puH3/y+AtP8jZ5f/KWKH/0p7hP+ZrVr/zcUt/9vMKf/bzSz/tsBP/3OzrP9kl7Pp
AAAAgHGdpThatuT/0fn+//b///+V0uv/NICu/4mvfP/czjL/3M0v/9rMKP/dzzT/3c83/9vNLf/b
zS//nrWA/gAAAIMAMzMFbrrd2d/+///5////t+n6/4q6nf/czzX/3tA+/97QPf/czjP/3dA7/97R
Qv/czjD/3M4z/9DHLPoAAAB/AAAAAWShtUix5+//5v7+/5Hf7//Bvjn/3M0v/9/SSP/g1FL/39RR
/+DVWv/e0kf/3tFA/9zNL//bzCj/AAAAbwAAAAAAAAADcq7Fmpzo8f9rsL3/2ssl/93POf/f0kj/
49pu/+ffhP/q45b/49pp/97SSv/czS//yb0q4wAAAE8AAAAAAAAAAF54hhNrq77BXpCj/7+7Of/c
zjH/3tFH/+bdeP/w7cv/9PLa/+zlnf/g1VP/1so5/mBfJHsAAAArAAAAAAAAAAAAAAABa5GgIHWs
t/dymG3/3tE//9/UUv/o4Ij/9PHT//v67P/v6a3/08xY/3uMX6UAAAAuAAAAEAAAAAAAAAAAAAAA
AAAAAAKSvb9YSoWa+WyagP+wv2X/4NRO/+ngfv/m4Zf/rLeB+lpubIkAAAAlAAAADgAAAAMAAAAA
AAAAAAAAAAAAAAAAAAAAAoqvuDxkkp2gYo+c51mHkv9lk5v/Y4eNtlBfaEgAAAAWAAAACQAAAAIA
AAAAAAMAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAwAAAAMAA
AADgAAAA8AEAAA==
</gtb:icon>
</feed>
上記の例は Atom 1.0 フィードで、 Google カスタム ボタンのネームスペースは次のように指定されています。 xmlns:gtb='http://toolbar.google.com/custombuttons/' ボタンと同時に更新されるツールのヒントを上書きするには、次のように指定します。 <gtb:description> new-description </gtb:description> ボタンと同時に更新されるアイコンを上書きするには、次のように指定します。 <gtb:icon> icon-base64-code </gtb:icon> この複雑な "mood" 分析システムを実行するる PHP スクリプトは次のようになります。 <?php
header('Content-type: text/xml');
switch(rand(1, 7)) {
case 1:
$icon = "amber.ico";
$desc = "Amber:\nNervous, on edge, uncertain";
break;
case 2:
$icon = "black.ico";
$desc = "Black:\nTense, stressed, working too hard";
break;
case 3:
$icon = "blue.ico";
$desc = "Blue:\nComfortable, breeze, at rest, loveable";
break;
case 4:
$icon = "bluegreen.ico";
$desc = "Bluegreen:\nHeightened inner emotional state, moderately relaxed";
break;
case 5:
$icon = "gray.ico";
$desc = "Gray:\nAnxious, ill at ease, strained";
break;
case 6:
$icon = "green.ico";
$desc = "Green:\nSteady, stable, no emotional turmoil";
brea;
case 7:
$icon = "purple.ico";
$desc = "Dark Blue:\nImpassioned, delighted, whiff of romance";
break;
}
$icon = base64_encode(file_get_contents($icon));
echo "<?xml version='1.0'?>";
echo "\n<feed xmlns='http://www.w3.org/2005/Atom' xmlns:gtb='http://toolbar.google.com/custombuttons/'>";
echo "\n<id>http://www.example.com/custombuttons/samples/feeds/mood</id>";
echo "\n<title>Mood</title>";
echo "\n<link href='http://www.google.com/search?q=$mood+ring' />";
echo "\n<link rel='self' href='http://www.example.com/custombuttons/samples/feeds/mood' />";
echo "\n<gtb:description>$desc</gtb:description>";
echo "\n<gtb:icon mode='base64' type='image/x-icon'>$icon</gtb:icon>";
echo "\n</feed>";
?>
アイコンはスクリプトと同じフォルダに保存します。 フィードを使用してボタンとプルダウン メニューのアイコンを更新する
フィードのプルダウン メニューのそれぞれのアイテムにサーバー ベースのカスタム アイコンを追加することもできます。 フィードにデフォルトでプルダウン メニューのある天気予報のボタンの例は次のとおりですが、正しくサーバーに接続した際にメニュー アイテムを表示しない
<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
<button>
<title>Weather 94043</title>
<description>Weather updates for Mountain View, CA</description>
<site>http://www.google.com/search?q=weather+94043&num=1</site>
<feed refresh-interval="3600" refresh-menuitem="false">
http://www.example.com/custombuttons/samples/feeds/weather?zip=94043</feed>
</button>
</custombuttons>
次はプルダウン メニューのそれぞれのアイテムの横にカスタム アイコンのある天気予報のフィードの例です (よりわかりやすくするため、ほとんどのアイコンの base64 データは省いてあります)。 上記の例は次の URL でご覧いただけます。: <?xml version='1.0'?>
<feed xmlns='http://www.w3.org/2005/Atom'
xmlns:gtb='http://toolbar.google.com/custombuttons/'>
<id>http://www.example.com/custombuttons/samples/feeds/weather</id>
<title>Weather Mountain View, CA</title>
<link href='http://www.google.com/search?q=weather+94043/' />
<link rel='self'
href='http://www.example.com/custombuttons/samples/feeds/weather' />
<gtb:description>Mountain View, CA
63F Mostly Cloudy
Humidity: 48%
Wind: NW at 8 mph</gtb:description>
<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoANUAAEuc/Pz8/Fik/Ii00k9daZGPivLy8tbW1k2R0uvr6wZj3HSq0f/QMMfHx7a2
tj2F0fu0EePj4yx81neUp4J/eKanphJq3IJtOGB3iI3C5BFt5B5XnWis7H2346jO5/6+IWKo8923
... and so on...
</gtb:icon>
<entry>
<title>Today: Mostly Cloudy 65 | 50</title>
<link href='http://www.google.com/search?q=weather+94043/' />
<id>http://www.example.com/custombuttons/samples/feeds/weather/0</id>
<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoANUAAEuc/Pz8/Fik/Ii00k9daZGPivLy8tbW1k2R0uvr6wZj3HSq0f/QMMfHx7a2
tj2F0fu0EePj4yx81neUp4J/eKanphJq3IJtOGB3iI3C5BFt5B5XnWis7H2346jO5/6+IWKo8923
... and so on...
</entry>
<entry>
<title>Thu: 66 | 51</title>
<link href='http://www.google.com/search?q=weather+94043/' />
<id>http://www.example.com/custombuttons/samples/feeds/weather/1</id>
<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoAPcAAAAAAP///4WOwPT1+tDT3unr8sHG1ff5/6Wy0mZ8rGqAr3mJrJakxa+zvHSK
tcDBw1R2slBql110njBXjztmqS9OfjtekTZWhGeJuoqctklLTgJYyQJQtQ9hzhRr3BZlzBVRoS1S
... and so on...
</gtb:icon>
</entry>
<entry>
<title>Fri: 67 | 51</title>
<link href='http://www.google.com/search?q=weather+94043/' />
<id>http://www.example.com/custombuttons/samples/feeds/weather/2</id>
<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoANUAAObm52ms7k2Q0Uuc/Fmk+v2zDoS01HOp0avP5tvb26CPXQZj3DqG14yLh05Y
Yf/IKv/VN3mCiMPDw6SkpCt82GhxePz8/JG+2pd5NRZu3hBq3fb29rCAFrm5uSN549OWE4WltqHI
... and so on...
</gtb:icon>
</entry>
<entry>
<title>Sat: 67 | 50</title>
<link href='http://www.google.com/search?q=weather+94043/' />
<id>http://www.example.com/custombuttons/samples/feeds/weather/3</id>
<gtb:icon mode='base64' type='image/x-icon'>
R0lGODlhKAAoANUAAObm52ms7k2Q0Uuc/Fmk+v2zDoS01HOp0avP5tvb26CPXQZj3DqG14yLh05Y
Yf/IKv/VN3mCiMPDw6SkpCt82GhxePz8/JG+2pd5NRZu3hBq3fb29rCAFrm5uSN549OWE4WltqHI
... and so on...
</gtb:icon>
</entry>
</feed>
ツールバーのフィードにも同じ'http://toolbar.google.com/custombuttons/' ネームスペースと説明、または RSS 1.0、RSS 2.0、Atom 1.0、Atom 0.3 フィードのアイコン タグを使用できます。 複数の言語カスタム ボタンは、複数の URL やツールバーのロケールのアイコンとテキストに対応しています。 これを実行する 2 つの方法については、次をご覧ください。最初の方法をお勧めします。 ロケール属性を使用する
推奨する方法は、XML タグの一覧を作成する方法で、 <?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
<button>
<title>Wikipedia</title>
<site>http://www.wikipedia.org</site>
<site locale="fr">http://fr.wikipedia.org</site>
<site locale="es">http://es.wikipedia.org</site>
<description>The Free Encyclopedia</description>
<description locale="fr">L'encyclopdie libre</description>
<description locale="es">La enciclopedia libre</description>
</button>
</custombuttons>
ツールバーの言語を使用しているロケールが XML タグのディレクトリに見つからない場合は、上記の一覧の最初のタグがデフォルトとして使用されます。 {locale} 変数の使用
別の方法は、 ISO ロケール テーブル現時点で対応しているロケールは次のとおりです。
ボタンのホスト先についてボタンの XML ファイルのホストに使用するダウンロード先 URL をどこにするかは、その URL がボタン更新時のボタン固有の ID となるため、重要です。 同一の URL でダウンロードを繰り返しても、ツールバーでは古いボタンの置き換えのみが行われ、新しいボタンが追加されることはありません。 詳細については、カスタム ボタンの更新をご覧ください。 自作のボタンを Google ボタン ギャラリー に追加する自作のボタンを Google のボタン ギャラリー に追加することで、世界中の人々に自分の新しいボタンを知らせることができます。 そのためには、XML ファイルが既にどこかにホストされており (ボタン ギャラリー からファイルに直接リンクされます)、ボタンが Google の編集ガイドラインに準拠している必要があります。 ご自身のウェブ サイトのボタンを作成された場合は、サイトと同じドメインで XML ファイルをホストしてください。 Google のボタン ギャラリー にあるボタンは、ボタンがアクセスするドメインと同じドメインにホストされている場合、"公式" なものと認められます。 これによって、ユーザーはお客様のサイトへ導かれる公式なボタンを簡単に見つけることができます。 完了したらボタン ギャラリー の申請フォームに記入し、ボタンの詳細を Google までお知らせください。 サイトからボタンにリンクを貼るインストール リンクを作成すると、ご自身のサイトでボタンの配布ができるようになります。 Google ツールバー 4 のユーザーがそのリンクをクリックすると、設定されたボタンをインストールできることを通知するメッセージが表示されます。 ユーザーが互換性のあるツールバーをインストールしていない場合は、Google ツールバーのダウンロードのページが表示されます。 開発者は次の URL シンタックスを使用して、インストール リンクを作成することができます。 http://toolbar.google.com/buttons/add?url=url
上記 url はカスタム ボタンの XML ファイルが存在する URL です。 たとえば、Slashdot.com ボタンをインストールするリンクは次のとおりです。 <a href="http://toolbar.google.com/buttons/add?url=http://www.slashdot.org/slashdot_button.xml">Add</a> このリンクのラベルは Add です。 ユーザーがこのリンクをクリックすると、Slashdot.com のボタンがユーザーのツールバーにインストールされます。 上記の Google URL は、基本的にはツールバーのカスタム ボタンをインストールする URL です。 ユーザーが互換性のあるツールバーをインストールしていない場合は、Goolge ツールバーのダウンロードのページが表示されます。 Google ツールバーがインストールされると、カスタム ボタンは自動的に追加されます。 フィード トラフィックを管理するフィードを含むウェブ トラフィックには問題が起こる可能性があります。 ボタンが誘導するフィードの人気が出て、トラフィックが増加することが予想される場合は、回線容量の少ないサーバーにリンクさせない方がよいでしょう。 更新のリクエストによって負荷がかかりすぎる場合があります。 カスタム ボタンにはフィード用の refresh-interval 属性があります。 ツールバーは、サーバーが HTTP ヘッダーに記述する "Expires" 時間に従います。 この設定は、ボタンの refresh-interval を上書きします。 サーバーに負荷がかかりすぎた場合は、この "Expires" 時間を延ばし、負荷がかからないようにします。 たとえば、ボタンを 1 時間ごとに更新するように設定してある場合、"Expires" 時間で更新が 1 日に 1 度行われるように設定すれば、トラフィックを大幅に減らすことができます。
<?php
$expires = gmdate("D, d M Y H:i:s", time() + 3600 * 24 * 7) . " GMT";
Header("Expires: " . $expires);
?>
サーバーからの HTTP レスポンスの例: HTTP/1.1 200 OK Date: Thu, 05 Jan 2006 23:39:54 GMT Server: Apache/2.0.47 (Red Hat Linux) Accept-Ranges: bytes X-Powered-By: PHP/4.3.2 Expires: Thu, 12 Jan 2006 23:39:54 GMT Transfer-Encoding: chunked Content-Type: text/html備考 XML リファレンスカスタム ボタンの XML ファイルは次のような構造を持っています。
<?xml version="1.0" encoding="utf-8"?>
<custombuttons xmlns="http://toolbar.google.com/custombuttons/">
<button>
<!-- XML elements -->
</button>
</custombuttons>
次の XML 要素は
エスケープ文字XML ファイル (および HTML ファイル) の文字列は、次にあるようにエスケープする必要があります。
変数の参照
注: 条件付き
次の変数、またはエスケープ パラメータは指定された範囲に列挙された要素に使われます。 たとえば、
|
