參考指南

重要事項:這是舊版頁面。如要取得最新版本,請使用左側導覽列中的連結。

本文件提供 Blogger Data API 原始通訊協定 (XML 和 HTTP) 的詳細參考文件。

本文件不包含程式設計語言用戶端程式庫的相關資訊。如需用戶端程式庫參考資訊,請參閱開發人員指南中的程式設計語言相關章節。

目錄

觀眾

本文件的適用對象為想撰寫可與 Blogger 互動的用戶端應用程式的程式設計人員。

這份參考文件假設您已瞭解開發人員指南所說明的概念,以及 Google Data API 通訊協定背後的一般概念。

Blogger 動態饋給類型

Blogger 提供兩種網誌內容表示法:完整動態饋給和摘要動態饋給。完整動態饋給包含完整的網誌文章,摘要動態饋給則只包含每篇文章的簡短摘要。

網誌擁有者可透過 GUI 設定指定網誌是否提供完整動態饋給或摘要動態饋給給聯合發布和集結網站。

當用戶端應用程式針對動態饋給傳送未經驗證的要求時,就會接收網誌擁有者指定哪一種動態饋給類型。

然而,當用戶端應用程式傳送經過驗證的要求時,無論網誌擁有者指定什麼,一律都會收到完整的動態消息。

Blogger 查詢參數參考資料

Blogger Data API 支援幾乎所有標準 Google Data API 查詢參數

Blogger 不支援 q (文字搜尋) 和 author 參數。

除非 orderby 參數設為 updated,否則系統會忽略 updated-minupdated-max 查詢參數。例如,下列網址會擷取從 2008 年 3 月 16 日到 2008 年 3 月 24 日更新的所有網誌文章:

http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated

Blogger 元素參考資料

Blogger Data API 僅使用標準 Atom 元素;詳情請參閱 Atom 1.0 聯合發布格式規格Atom 發布通訊協定

本節其餘部分則提供 Blogger 使用部分標準元素的一些具體注意事項。

草稿項目

系統會使用 Atom 發布通訊協定文件中定義的 <app:draft> 擴充功能元素,標示網誌草稿。以下是項目草稿的範例:

<entry xmlns:app='http://purl.org/atom/app#'>
...
<app:control>
<app:draft>yes</app:draft>
</app:control>
</entry>

如未指定 <draft> 元素,則項目不會為草稿。

發布日期和更新的日期

標準 Atom <published> 元素中的時間戳記對應了使用者可在 Blogger GUI 中設定的「發布日期」。

當用戶端建立新項目時,如果用戶端未指定 <published> 的值,則 Blogger 會將該項目的張貼日期設為目前的伺服器時間。當用戶端編輯項目但不指定 <published> 值時,Blogger 只會保留該項目的發布日期。

不過,如果您的用戶端在建立或編輯項目時指定了 <published> 元素的值,則 Blogger 會將該項目的張貼日期設為指定值。在執行其他工作時,像是從其他網誌系統匯入舊項目 (同時保留原始建立日期) 時,這個做法就很實用。

Blogger 會使用標準 Atom <updated> 元素來指出項目上次變更的時間。您的用戶端無法控制 <updated> 值;每當您的用戶端發布或編輯項目時,Blogger 一律會將項目的上次更新時間設為目前的伺服器時間。

您可以使用標準 Google Data API published-minpublished-maxupdated-minupdated-max 查詢參數,根據其 <published><updated> 值要求項目。不過,如需查詢更新日期的注意事項,請參閱 Blogger 查詢參數參考資料

將留言連結至訊息

Blogger 匯出格式在同一份 Atom 動態消息文件中同時包含文章和留言項目。 為區分這兩種項目,Blogger 會使用 <atom:category> 元素。這個元素將包含 term 參數,指出該項目是針對貼文或留言。

此外,將留言項目連結至其所屬的貼文項目,會透過 Atom Threading Extension 進行連結。在以下範例中,留言項目中的 <thr:in-reply-to> 元素會使用 ref 參數中的文章項目 ID,指向該文章。並透過 href 參數連結至文章的 HTML 網址。

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
      xmlns:thr="http://purl.org/syndication/thread/1.0">
  ...

  <-- A blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <content type="html">This is my first post</content>
    <link rel="alternate" type="text/html"
      href="http://blogName.blogspot.com/2007/04/first-post.html">
    </link>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#post"/>
    ...
  </entry>

  <-- A comment to the blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
    <content type="html">This is my first commment</content>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#comment"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     type="text/html"/>
    ...
  </entry>
</feed>

返回頁首