Google Reader 是一个使用了大量JavaScript构建的feed聚合器,它能非常及时地抓取最新的feed数据。Google的Ajax前台调用到的数据采用了Atom格式,这种数据技术降低了Google Reader的开发难度,同时也使得第三方应用很容易对其进行扩展。接下来我将带你提前预览Google Reader API。
晚上10:40更新:Google Reader的产品经理Jason Shellen告诉我Google是先建立feed的API,然后才在这些数据之上建立的程序,这无疑是一个如何利用这些数据的典范。Jason肯定了我接下来这些文档的准确性,而且宣称Google计划“很快”(有可能是一个月内)将发布一个关于feed的API。同时,Google Reader的工程师Chris Wetherell也确认了这些说法。
对新的聚合器开发者来说,由第三方提供的稳定可靠的feed解析服务能有效地降低其入门难度。Google和他们的工程师、服务器集群能够处理各种不同格式和验证状态的feed,使得开发者能把精力集中到交互体验和其他功能上来。你可以建立基于大量用户的应用,获取和同步他们的feed订阅列表,并且给用户提供基于不同设备和平台的更好体验。Google Reader本身只是给这些有用的数据提供了一种视图而已。
Google Reader对使用其feed系统的用户分配了20位数字构成的用户ID,用户各种数据的获取,都需要利用到domain为google.com下的名叫SID的cookie字段。
Feed获取
/reader/atom/feed/
不管feed一开始采用了什么格式,Google都将其转化为Atom格式。所有的RSS feed包含一切在提要里边出现的所有元素,这一点和My Yahoo! backend不一样,Yahoo的不包含任何附加的元数据。
你可以一下的格式从Google Reader访问任何feed:
- http://www.google.com/reader/atom/feed/ + [Feed地址]
- Niall Kennedy’s Weblog (RSS 2.0)
- Niall’s Flickr feed (Atom 0.3)
- del.icio.us popular (RDF)
你可以通过参数n设置返回的文章数量,默认为20。
Google忽略掉在阅读器里边没有用的数据,它们包括命名空间(如Apple iTunes podcast、Yahoo! Media RSS的命名空间)、作者信息(如email、主页地址等)、甚至于版权等内容。
订阅列表
/reader/atom/user/[user id]/pref/com.google/subscriptions
Google Reader的feed订阅列表包含用户当前订阅的和已经被删除的订阅。每个feed包含其地址、发布和更新时间、用户标记的标签(如果有的话)。当前订阅都被归类到阅读列表状态。通过设置complete为true,你还可以获取到所有的feed列表。
这里是我在Google Reader用户ID全部为0的账户的订阅列表。我没有订阅我自己的RSS feed,不过给我的Atom feed打上了标签。不管在原feed里边是否声明了作者,在每个列出的feed包含author元素都是空的。也许Google计划增加feed的认领服务,不过即使是他们自己的Google Blog,也还是没有任何额外的作者信息。
阅读列表
/reader/atom/user[user id]/state/com.google/reading-list
我最喜欢Google Reader的阅读列表功能,它能直接访问到我订阅feed中所有未读的文章,以一种“新闻流”的方式展现它们。
这里有一个我的阅读列表的例子,你同样可以通过参数n设置返回文章的数量。
已阅读文章
http://www.google.com/reader/atom/user/[user ID]/state/com.google/read
你可以通过这个API获取到用户在Google Reader里边已读的文章。如果想通过用户最近阅读的100篇文章分析其趋势或者实现对它们的查询,那么这个功能就很有用了。参数n同样可以设置返回的文章数量。
某标签下的文章列表
/reader/atom/user/[user id]/label/[tag]
你还可以查看指定标签下最近发表的文章。比如你把很多feed标记为“营销”,只是想访问有关营销的feed,这就很有用了。返回的内容中包含已读和未读的文章。已读的文章被归类到已读(state/com.google/read),你可以通过这判断是否将它们隐藏起来。返回的数量可以通过参数n来判断。
标星文章
/reader/atom/user[user id]/state/com.google/starred
Google Reader允许用户对文章标星。这些标星文章包括有feed地址、标签、发布/更新时间。你可以通过参数n指定返回的数量,默认为20。
Google将标星项目视作一种特殊的标签,因此输出的内容和标签下文章列表结构一致。
添加或删除订阅
/reader/api/0/edit-subscription
使用POST请求访问Google Reader的API,你可以添加任何feed到Google Reader的订阅列表。
- /reader/api/0/edit-subscription -- 基本地址
- ac=["subscribe" 或者 "unsubscribe"] -- 请求动作
- s=feed%2F[feed URL] -- 请求的订阅
- T=[命令标识] -- Google发布的具有时效性的标识,可以通过/reader/api/0/token获取。
添加标签
/reader/api/0/edit-tag
通过HTTP的POST请求可以给一个feed或单独的文章打上标签。
- /reader/api/0/edit-tag -- 基本地址
- s=feed%2F[feed URL] -- 你想打标签的feed地址
- i=[item id] -- 出现在feed中的文章的id,可选,用来给个别的文章打标签。
- a=user%2F[user ID]%2Flabel%2F[标签] -- 请求动作,添加标签给feed,文章,或者两者。
- a=user%2F[user ID]%2Fstate%2Fcom.google%2Fstarred -- 标星文章。
- T=[special scramble] -- 关于用户和新标签的信息。可能处于安全因素考虑,尚未公开。
总结
基于对Google上面这些和县官服务的请求,你有可能构建自己的feed阅读器。你可以把Google作为你的后台,创建具有全新体验的在线和离线的程序,利用Google的ID,略施小计,你还可以创建更加高级的功能。
Google已经在这些数据API之上建立了第一个程序——Google Reader,从他们对API地址的选择之上来看的话,Google Reader应该不是最后一个基于这些数据集的程序。我喜欢数据调用的开放,Google Reader 的API是如此简单,相信会引导Google和第三方开发者创建更多的新应用!