關(guān)于Google Reader API

楊竹青

Google Reader 是一個(gè)使用了大量JavaScript構(gòu)建的feed聚合器，它能非常及時(shí)地抓取最新的feed數(shù)據(jù)。Google的Ajax前臺(tái)調(diào)用到的數(shù)據(jù)采用了Atom格式，這種數(shù)據(jù)技術(shù)降低了Google Reader的開(kāi)發(fā)難度，同時(shí)也使得第三方應(yīng)用很容易對(duì)其進(jìn)行擴(kuò)展。接下來(lái)我將帶你提前預(yù)覽Google Reader API。

晚上10:40更新：Google Reader的產(chǎn)品經(jīng)理Jason Shellen告訴我Google是先建立feed的API，然后才在這些數(shù)據(jù)之上建立的程序，這無(wú)疑是一個(gè)如何利用這些數(shù)據(jù)的典范。Jason肯定了我接下來(lái)這些文檔的準(zhǔn)確性，而且宣稱Google計(jì)劃“很快”（有可能是一個(gè)月內(nèi)）將發(fā)布一個(gè)關(guān)于feed的API。同時(shí)，Google Reader的工程師Chris Wetherell也確認(rèn)了這些說(shuō)法。

對(duì)新的聚合器開(kāi)發(fā)者來(lái)說(shuō)，由第三方提供的穩(wěn)定可靠的feed解析服務(wù)能有效地降低其入門難度。Google和他們的工程師、服務(wù)器集群能夠處理各種不同格式和驗(yàn)證狀態(tài)的feed，使得開(kāi)發(fā)者能把精力集中到交互體驗(yàn)和其他功能上來(lái)。你可以建立基于大量用戶的應(yīng)用，獲取和同步他們的feed訂閱列表，并且給用戶提供基于不同設(shè)備和平臺(tái)的更好體驗(yàn)。Google Reader本身只是給這些有用的數(shù)據(jù)提供了一種視圖而已。

Google Reader對(duì)使用其feed系統(tǒng)的用戶分配了20位數(shù)字構(gòu)成的用戶ID，用戶各種數(shù)據(jù)的獲取，都需要利用到domain為google.com下的名叫SID的cookie字段。

Feed獲取

/reader/atom/feed/

不管feed一開(kāi)始采用了什么格式，Google都將其轉(zhuǎn)化為Atom格式。所有的RSS feed包含一切在提要里邊出現(xiàn)的所有元素，這一點(diǎn)和My Yahoo! backend不一樣，Yahoo的不包含任何附加的元數(shù)據(jù)。

你可以一下的格式從Google Reader訪問(wèn)任何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)
你可以通過(guò)參數(shù)n設(shè)置返回的文章數(shù)量，默認(rèn)為20。

Google忽略掉在閱讀器里邊沒(méi)有用的數(shù)據(jù)，它們包括命名空間（如Apple iTunes podcast、Yahoo! Media RSS的命名空間）、作者信息（如email、主頁(yè)地址等）、甚至于版權(quán)等內(nèi)容。

訂閱列表

/reader/atom/user/[user id]/pref/com.google/subscriptions

Google Reader的feed訂閱列表包含用戶當(dāng)前訂閱的和已經(jīng)被刪除的訂閱。每個(gè)feed包含其地址、發(fā)布和更新時(shí)間、用戶標(biāo)記的標(biāo)簽（如果有的話）。當(dāng)前訂閱都被歸類到閱讀列表狀態(tài)。通過(guò)設(shè)置complete為true，你還可以獲取到所有的feed列表。

這里是我在Google Reader用戶ID全部為0的賬戶的訂閱列表。我沒(méi)有訂閱我自己的RSS feed，不過(guò)給我的Atom feed打上了標(biāo)簽。不管在原feed里邊是否聲明了作者，在每個(gè)列出的feed包含author元素都是空的。也許Google計(jì)劃增加feed的認(rèn)領(lǐng)服務(wù)，不過(guò)即使是他們自己的Google Blog，也還是沒(méi)有任何額外的作者信息。

閱讀列表

/reader/atom/user[user id]/state/com.google/reading-list

我最喜歡Google Reader的閱讀列表功能，它能直接訪問(wèn)到我訂閱feed中所有未讀的文章，以一種“新聞流”的方式展現(xiàn)它們。

這里有一個(gè)我的閱讀列表的例子，你同樣可以通過(guò)參數(shù)n設(shè)置返回文章的數(shù)量。

已閱讀文章

http://www.google.com/reader/atom/user/[user ID]/state/com.google/read

你可以通過(guò)這個(gè)API獲取到用戶在Google Reader里邊已讀的文章。如果想通過(guò)用戶最近閱讀的100篇文章分析其趨勢(shì)或者實(shí)現(xiàn)對(duì)它們的查詢，那么這個(gè)功能就很有用了。參數(shù)n同樣可以設(shè)置返回的文章數(shù)量。

某標(biāo)簽下的文章列表

/reader/atom/user/[user id]/label/[tag]

你還可以查看指定標(biāo)簽下最近發(fā)表的文章。比如你把很多feed標(biāo)記為“營(yíng)銷”，只是想訪問(wèn)有關(guān)營(yíng)銷的feed，這就很有用了。返回的內(nèi)容中包含已讀和未讀的文章。已讀的文章被歸類到已讀（state/com.google/read），你可以通過(guò)這判斷是否將它們隱藏起來(lái)。返回的數(shù)量可以通過(guò)參數(shù)n來(lái)判斷。

標(biāo)星文章

/reader/atom/user[user id]/state/com.google/starred

Google Reader允許用戶對(duì)文章標(biāo)星。這些標(biāo)星文章包括有feed地址、標(biāo)簽、發(fā)布/更新時(shí)間。你可以通過(guò)參數(shù)n指定返回的數(shù)量，默認(rèn)為20。

Google將標(biāo)星項(xiàng)目視作一種特殊的標(biāo)簽，因此輸出的內(nèi)容和標(biāo)簽下文章列表結(jié)構(gòu)一致。

添加或刪除訂閱

/reader/api/0/edit-subscription

使用POST請(qǐng)求訪問(wèn)Google Reader的API，你可以添加任何feed到Google Reader的訂閱列表。

/reader/api/0/edit-subscription -- 基本地址
ac=["subscribe" 或者 "unsubscribe"] -- 請(qǐng)求動(dòng)作
s=feed%2F[feed URL] -- 請(qǐng)求的訂閱
T=[命令標(biāo)識(shí)] -- Google發(fā)布的具有時(shí)效性的標(biāo)識(shí)，可以通過(guò)/reader/api/0/token獲取。
添加標(biāo)簽

/reader/api/0/edit-tag

通過(guò)HTTP的POST請(qǐng)求可以給一個(gè)feed或單獨(dú)的文章打上標(biāo)簽。

/reader/api/0/edit-tag -- 基本地址
s=feed%2F[feed URL] -- 你想打標(biāo)簽的feed地址
i=[item id] -- 出現(xiàn)在feed中的文章的id，可選，用來(lái)給個(gè)別的文章打標(biāo)簽。
a=user%2F[user ID]%2Flabel%2F[標(biāo)簽] -- 請(qǐng)求動(dòng)作，添加標(biāo)簽給feed，文章，或者兩者。
a=user%2F[user ID]%2Fstate%2Fcom.google%2Fstarred -- 標(biāo)星文章。
T=[special scramble] -- 關(guān)于用戶和新標(biāo)簽的信息。可能處于安全因素考慮，尚未公開(kāi)。
總結(jié)

基于對(duì)Google上面這些和縣官服務(wù)的請(qǐng)求，你有可能構(gòu)建自己的feed閱讀器。你可以把Google作為你的后臺(tái)，創(chuàng)建具有全新體驗(yàn)的在線和離線的程序，利用Google的ID，略施小計(jì)，你還可以創(chuàng)建更加高級(jí)的功能。

Google已經(jīng)在這些數(shù)據(jù)API之上建立了第一個(gè)程序——Google Reader，從他們對(duì)API地址的選擇之上來(lái)看的話，Google Reader應(yīng)該不是最后一個(gè)基于這些數(shù)據(jù)集的程序。我喜歡數(shù)據(jù)調(diào)用的開(kāi)放，Google Reader 的API是如此簡(jiǎn)單，相信會(huì)引導(dǎo)Google和第三方開(kāi)發(fā)者創(chuàng)建更多的新應(yīng)用！