Google ブログ検索の更新通知 API を利用すると、Google ブログ検索にブログの更新情報を自動で通知でき、ブログを頻繁に更新する場合などに便利です。また、ブログ サービス プロバイダの管理者は API を使用して、プラットフォーム上のブログの更新情報を Google に通知できます。Google ブログ検索への自動更新通知を設定するには、リクエストを送信する XML-RPC クライアントまたは REST クライアントを下記の手順で作成します。いずれの通知方法も同じように処理されます。
XML-RPC クライアントで作成するリクエストには下記の要素を含める必要があります。
RPC エンドポイント: http://blogsearch.google.co.jp/ping/RPC2
メソッド名: weblogUpdates.extendedPing
パラメータ: (下記の順序で送信する必要があります)
- サイトの名前
- サイトの URL
- 変更をチェックするページの URL
- RSS、RDF、Atom フィードの URL
- オプション サイトのコンテンツを分類する名前またはタグ。複数の値は "|" 文字で区切ります。
XML-RPC レスポンスには、<struct> と 2 つのメンバが含まれます。
- flerror (ブール値): エラーが発生した場合は、1 (true) に設定されます
- メッセージ (文字列): 成功した場合は"Thanks for the ping."、失敗した場合はエラー メッセージが入ります。
リクエストの例:
POST /RPC2 HTTP/1.0
User-Agent: request
Host: blogsearch.google.co.jp
Content-Type: text/xml
Content-length: 447
<?xml version="1.0"?>
<methodCall>
<methodName>weblogUpdates.extendedPing</methodName>
<params>
<param>
<value>Google 公式ブログ</value>
</param>
<param>
<value>http://googleblog.blogspot.com/</value>
</param>
<param>
<value>http://googleblog.blogspot.com/</value>
</param>
<param>
<value>http://googleblog.blogspot.com/atom.xml</value>
</param>
</params>
</methodCall>
レスポンスの例
HTTP/1.1 200 OK
Connection: close
Content-Length: 451
Content-Type: text/xml
Date: Sun, 30 Sep 2001 20:02:30 GMT
Server: Apache
<?xml version="1.0"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>flerror</name>
<value>
<boolean>0</boolean>
</value>
</member>
<member>
<name>message</name>
<value>更新を通知しました</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
REST クライアントで作成するリクエストには下記の要素を含める必要があります。
URL: http://blogsearch.google.co.jp/ping
パラメータ:
- name = ブログの名前
- url = ブログの URL
- changesURL = RSS、RDF、Atom フィードの URL (オプション)
レスポンスは、成功した場合は"Thanks for the ping"、失敗した場合はエラー メッセージのプレーン テキスト コンテンツとなります。
例:
Google では、ブログ検索の更新通知履歴は XML 形式で http://blogsearch.google.co.jp/changes.xml で公開されます。changes.xml ファイル フォーマットは、ルートの <weblogUpdates> 要素と 1 つ以上の <weblog> 要素で構成されます。
<weblogUpdates version="2" updated="Wed, 30 May 2006 14:10:00 GMT" count="1384779">
<weblog name="誰かさんのブログ"
url="http://googleblog.blogspot.com"
rssUrl="http://googleblog.blogspot.com/atom.xml"
when="1"/>
...
</weblogUpdates>
<weblogUpdates> 要素
- version:主要なフォーマットの変更を示すために使用します。現在のバージョンは 2 です。
- updated: HTTP 1.0 フォーマットの日付時間です。ファイルの最終更新日を表します。
- count: changes.xml のバージョンを表すカウント番号です。新しいバージョンの changes.xml はより大きい値となります。
- name: ブログの名前です。
- url: ブログの URL です。
- rssUrl: フィード、RSS、Atom、またはその他のデータの URL です。
- when:更新通知の時間を特定するため、weblogUpdate 要素の更新された属性から差し引く秒数です。
|