本頁面由 Cloud Translation API 翻譯而成。

參考指南

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

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

本文件未包含程式設計語言相關資訊用戶端程式庫如需用戶端程式庫參考資訊，請參閱開發人員指南中程式設計語言專屬部分的連結。

目標對象

本文件適用於想編寫可與 Blogger 互動的用戶端應用程式的程式設計師。

這是參考文件建議您先瞭解開發人員指南中所述， Google Data API 背後的一般概念通訊協定。

Blogger 動態饋給類型

Blogger 在動態饋給中提供兩種網誌內容呈現方式：完整動態饋給和摘要動態饋給。完整動態饋給包含完整的網誌文章和摘要動態饋給只包含每篇文章的簡短摘要

網誌擁有者可以使用 GUI 設定，指定網誌要向發布者和集結器提供完整動態饋給還是摘要動態饋給。

當用戶端應用程式針對動態饋給傳送未經驗證的要求時，就會收到網誌擁有者指定的任何資訊提供類型。

不過，當用戶端應用程式傳送已驗證的要求時，無論網誌擁有者指定的內容為何，應用程式都會一律收到完整的動態饋給。

Blogger 查詢參數參考資料

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

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

updated-min 和 updated-max 查詢參數除非 orderby 參數已設為 updated。例如，下列網址會擷取網誌的所有文章已更新為 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 的具體注意事項使用一些標準元素

草稿項目

使用 <app:draft> 標記網誌項目的草稿 Atom Publishing Protocol 文件中定義的擴充功能元素。以下是草稿項目範例：

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

如果未指定 <draft> 元素，則該項目不是草稿。

發布日期和更新日期

標準 Atom <published> 中的時間戳記元素對應到「post date」使用者可在 Blogger 統一發票。

當用戶端建立新項目時，如果用戶端未指定值則 Blogger 將文章的發布日期設為 <published> 目前伺服器時間。當客戶編輯項目，但未指定 <published> 值，Blogger 會留下文章的文章日期。

不過，如果客戶在建立或編輯項目時為 <published> 元素指定值，Blogger 就會將項目的發布日期設為指定的值。這項功能可用於從其他網誌系統匯入舊文章 (並保留原始建立日期) 等工作。

Blogger 會使用標準 Atom <updated> 元素進行以下操作：表示項目的上次變更時間。您的客戶無法控制 <updated> 值；Blogger 一律將項目的上次更新時間那麼當您的用戶端張貼或編輯項目。

您可以使用標準 Google Data API published-min、published-max、updated-min 和 updated-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>

返回頁首