关于 Google“博客搜索”Ping 服务应用编程接口(API)
2009-04-24 14:43
519 查看
转自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请求的例子
XML-RPC响应的例子
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
Google 将所接受的“博客搜索” Ping 记录以XML格式发布到http://blogsearch.google.com/changes.xml。changes.xml文件格式包含一个根元素<weblogUpdates>和一个或多个的<weblog>元素。
<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 发生的时间的差值,单位为秒。
通过 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.0 User-Agent: request Host: blogsearch.google.com Content-Type: text/xml Content-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 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>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 发生的时间的差值,单位为秒。
相关文章推荐
- 【Android 应用开发】Android 网络编程 API笔记 - java.net 包相关 接口 api
- OpenGL是一个优秀的专业化的3D的API(Application Programming Interface,应用编程接口)
- 【Android 应用开发】Android 网络编程 API笔记 - java.net 包相关 接口 api
- TCPIP详解第1卷1.10标准化过程1.11RFC1.12标准的简单服务1.13互联网1.14实现1.15应用编程接口1.16测试网络
- 怎样用Google APIs和Google的应用系统进行集成(3)----调用Google 发现(Discovery)API的RESTful服务
- 利用ping服务接口API加快网站收录
- 关于google map api中的球平投影算法接口: GProjection和GMercatorProjection类
- 如何用Google APIs和Google的应用系统进行集成(3)----调用Google 发现(Discovery)API的RESTful服务
- API(应用编程接口或web服务)概念问题
- 关于一些Google Map API应用开发的资源收集整理
- XviD应用编程接口(API)简介(v0.1)
- 关于google map api中的球平投影算法接口: GProjection和GMercatorProjection类 - tim-wu - BlogJava
- 关于google map api中的球平投影算法接口: GProjection和GMercatorProjection类
- 关于android应用正式发布时Google map api key的处理
- Flask: 应用编程接口(API)(一)
- XviD应用编程接口(API)简介(v0.1)
- C# Google API 编程
- google map api 3 学习应用笔记 (1)
- API接口服务平台现状分析
- 微软最近对外发布了必应翻译应用开发接口(API),Facebook成为第一批尝鲜者