關於 Google“部落格搜尋”Ping 服務應用編程介面(API)

文章目錄

轉自Google協助：http://www.google.com/help/blogsearch/pinging_API.html

通過 Google“部落格搜尋”Ping API, 使用者可以程式化的方式將部落格內容的更新通知給 Google“部落格搜尋”引擎。這對於經常更新部落格內容的使用者尤其有用。部落格服務提供者的管理員也可以利用此API將其平台上的部落格內容變化向 Google 通告，以便 Google“部落格搜尋”及時抓取來自這一服務提供者的最新內容。為設定對 Google“部落格搜尋”的自動 Ping 機制，請按照如下所述設定XML-RPC用戶端或REST用戶端以發送請求。您可以任選一種方法進行通知；兩者都將按照相同的方式進行處理。

設定XML-RPC客戶

XML-RPC客戶的請求應包含如下元素：

RPC端點： http://blogsearch.google.com/ping/RPC2
調用方法名： weblogUpdates.extendedPing
參數： (應按照如下所列的相同順序傳送)

• 網站名
• 網站URL
• 需要檢查更新的頁面URL
• 相應的RSS、RDF或Atom種子的URL
• 可選 頁面內容的分類名稱(或標籤)。您可以指定多個值，之間用'|'字元進行分隔。

XML-RPC響應中將返回含有兩個元素的<struct> ：

• flerror (Boolean)：當有錯誤發生時設為true/1
• message (string) ："Thanks for the ping." (如果成功) 或者一個錯誤資訊(如果不成功)。

XML-RPC請求的例子

POST /RPC2 HTTP/1.0User-Agent: requestHost: blogsearch.google.comContent-Type: text/xmlContent-length: 447<?xml version="1.0"?><methodCall>  <methodName>weblogUpdates.extendedPing</methodName>  <params>    <param>      <value>Official Google Blog</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>

XML-RPC響應的例子

HTTP/1.1 200 OKConnection: closeContent-Length: 451Content-Type: text/xmlDate: Sun, 30 Sep 2001 20:02:30 GMTServer: 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>Thanks for the ping.</value>          </member>        </struct>      </value>    </param>  </params></methodResponse>

設定REST客戶

REST客戶的請求中包含如下元素：

URL: http://blogsearch.google.com/ping

參數:

• name = 部落格的名字
• url = 部落格的URL
• changesURL = RSS、RDF或Atom種子的URL (可選)

響應中將返迴文本內容，在成功的時候是"Thanks for the ping."，在失敗時是一條錯誤訊息。

例子：

http://blogsearch.google.com/ping?name=Official+Google+Blog&url=http%3A%2F%2Fgoogleblog.blogspot.com%2F&changesURL=http%3A%2F%2Fgoogleblog.blogspot.com%2Fatom.xml

changes.xml的格式

Google 將所接受的“部落格搜尋” Ping 記錄以XML格式發布到http://blogsearch.google.com/changes.xml。changes.xml檔案格式包含一個根項目<weblogUpdates>和一個或多個的<weblog>元素。

<weblogUpdates version="2" updated="Wed, 30 May 2006 14:10:00 GMT" count="1384779">  <weblog name="Some Blog"          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檔案通常具有更大的count值。

<weblog>元素

• name：Blog的名稱。
• url： Blog的url。
• rssUrl： 相應的RSS、Atom或其它種子的URL。
• when： <weblogUpdates>元素的updated屬性對應的時間減去相應的 Ping 發生的時間的差值，單位為秒。