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
- 擷取訊息的留言清單。
- 取得
- 依其
commentId 擷取一個註解資源。 - 核准
- 將留言標示為非垃圾內容。
- 刪除
- 依 ID 刪除留言。
- listByBlog
- 擷取網誌中所有文章的留言 (可能經篩選)。
- markAsSpam
- 將留言標示為垃圾內容。這會將註解的狀態設為「
spam
」,並在預設的註解顯示模式中隱藏該註解。 - removeContent
- 移除留言內容。