網誌是 Blogger API 的根資料類別。每個網誌都有一系列文章和頁面,而每篇報導都有一系列留言。
如需本資源的方法清單,請見本頁結尾。
資源表示法
{
"kind": "blogger#blog",
"id": value,
"name": value,
"description": value,
"published": value,
"updated": value,
"url": value,
"selfLink": value,
"posts": {
"totalItems": value,
"selfLink": value
},
"pages": {
"totalItems": value,
"selfLink": value
},
"locale": {
"language": value,
"country": value,
"variant": value
}
}
資源名稱 | 值 | 說明 | Notes |
---|---|---|---|
kind |
string |
此項目種類。一律為 blogger#blog 。 |
|
id |
string |
這項資源的 ID。 | |
name |
string |
這個網誌的名稱,通常在 Blogger 中會顯示為網誌的標題。標題可以包含 HTML。 | |
description |
string |
這個網誌的說明通常在 Blogger 的網誌標題下方顯示。說明可以包含 HTML。 | |
published |
datetime |
RFC 3339 date-time 發布於此網誌,例如「2007-02-09T10:13:10-08:00」。 |
|
updated |
datetime |
RFC 3339 date-time 上次更新網誌的時間,例如「2012-04-15T19:38:01-07:00」。 |
|
url |
string |
這個網誌的發布網址。 | |
selfLink |
string |
要擷取這項資源的 Blogger API 網址。 | |
posts |
object |
這篇網誌文章的容器。 | |
posts.totalItems |
integer |
此網誌上的文章總數。 | |
posts.selfLink |
string |
此網誌的文章集合網址。 | |
pages |
object |
這個網誌網頁的容器。 | |
pages.totalItems |
integer |
這個網誌的頁面總數。 | |
pages.selfLink |
string |
此網誌的網頁集合網址。 | |
locale |
object |
此網誌設定的語言代碼,如下所示。 | |
locale.language |
string |
這個網誌設定的語言,例如「en」,表示英文。 | |
locale.country |
string |
語言的國家/地區子類,例如「US」代表美式英文。 | |
locale.variant |
string |
此網誌設定的語言版本。 | |
customMetaData |
string |
網誌的 JSON 自訂中繼資料 | |
posts.items[] |
list |
此網誌的文章清單。 |
方法
如要擷取特定使用者具備存取權的網誌清單,請使用 blogger.blogs.list 方法。如要擷取個別 blogs 資源,請使用 blogger.blogs.get 方法。