通过 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
     
       
      
       weblogUpdates.extendedPing
        
          
             
       
        Official Google Blog
               
             
       
        http://googleblog.blogspot.com/
               
             
       
        http://googleblog.blogspot.com/
               
             
       
        http://googleblog.blogspot.com/atom.xml
             
      
     

XML-RPC响应的例子

---

HTTP/1.1 200 OKConnection: closeContent-Length: 451Content-Type: text/xmlDate: Sun, 30 Sep 2001 20:02:30 GMTServer: Apache
     
       
          
             
               
                  
                     
          
           flerror
                      
           
           
            0
            
                    
                   
                     
          
           message
                        
          
           Thanks for the ping.
                    
                 
              
             
      
     

设置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格式发布到。changes.xml文件格式包含一个根元素<weblogUpdates>和一个或多个的<weblog>元素。

       
        ...
     

• version：用来指示一个主要的格式变化，目前的版本是2。
• updated：以 格式表示的日期时间。它指示了该文件上一次更新的时间。
• count：一个递增的数字，表示了changes.xml文件的版本。新版本changes.xml文件通常具有更大的count值。

• name：Blog的名称。
• url： Blog的url。
• rssUrl： 相应的RSS、Atom或其它种子的URL。
• when： <weblogUpdates>元素的updated属性对应的时间减去相应的 Ping 发生的时间的差值，单位为秒。