留言

posts 資源的留言。

如需本資源的方法清單，請見本頁結尾。

資源表示法

{
  "kind": "blogger#comment",
  "status": string,
  "id": string,
  "inReplyTo": {
    "id": string
  },
  "post": {
    "id": string
  },
  "blog": {
    "id": string
  },
  "published": datetime,
  "updated": datetime,
  "selfLink": string,
  "content": string,
  "author": {
    "id": string,
    "displayName": string,
    "url": string,
    "image": {
      "url": string
    }
  }
}

屬性名稱	值	說明	附註
kind	string	這項資源的種類。一律 blogger#comment。
id	string	這項資源的 ID。
post	object	包含這則留言的貼文相關資料。
post.id	string	包含這則留言的貼文 ID。
blog	object	包含這則留言的網誌相關資料。
blog.id	string	含有這則留言的網誌 ID。
published	datetime	RFC 3339 date-time 留言發布的日期和時間，例如「2012-04-15T19:38:01-07:00」。
updated	datetime	RFC 3339 date-time 這個留言最近一次更新的時間，例如「2012-04-15T19:43:21-07:00」。
selfLink	string	從中擷取這項資源的 Blogger API 網址。
content	string	留言內容，可包含 HTML 標記。
author	object	這則留言的作者。
author.id	string	留言建立者的 ID。
author.displayName	string	留言者的顯示名稱。
author.url	string	留言者個人資料頁面的網址。
author.image	object	創作者顯示圖片網址的容器。
author.image.url	string	留言者顯示圖片的網址。
inReplyTo	object	這則留言回覆的留言相關資料。
inReplyTo.id	string	這則留言的父項 ID。
status	string	註解的狀態。只有具備網誌管理權限的使用者才能看到狀態。

方法

如要擷取貼文的留言清單，請使用 list 方法。如要擷取個別留言，請使用 get 方法。

list

擷取貼文的留言清單。

get

依 commentId 擷取一則留言資源。

核准

將留言標示為非垃圾內容。

刪除

依 ID 刪除留言。

listByBlog

擷取網誌中所有文章的留言，可選擇篩選。

markAsSpam

將留言標示為垃圾內容。這會將留言狀態設為 spam，並在預設留言顯示中隱藏該留言。

removeContent

移除留言內容。