Google ブログ検索の更新通知 API について

Google ブログ検索

Google ブログ検索について

Google ブログ検索 更新通知サービス

更新通知 API

利用規約

プライバシー ポリシー

Google ブログ検索の更新通知 API を利用すると、Google ブログ検索にブログの更新情報を自動で通知でき、ブログを頻繁に更新する場合などに便利です。また、ブログ サービス プロバイダの管理者は API を使用して、プラットフォーム上のブログの更新情報を Google に通知できます。Google ブログ検索への自動更新通知を設定するには、リクエストを送信する XML-RPC クライアントまたは REST クライアントを下記の手順で作成します。いずれの通知方法も同じように処理されます。

XML-RPC クライアントの設定

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 クライアントの設定

REST クライアントで作成するリクエストには下記の要素を含める必要があります。

URL: http://blogsearch.google.co.jp/ping

パラメータ:

• name = ブログの名前
• url = ブログの URL
• changesURL = RSS、RDF、Atom フィードの URL (オプション)

例:

changes.xml フォーマット

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>

<weblog> 要素