網誌是 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
}
}
資源名稱 | 價值 | 說明 | 附註 |
---|---|---|---|
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 方法。如要擷取個別網誌資源,請使用 blogger.blogs.get 方法。
- 取得
- 按 ID 擷取網誌。
- getByUrl
- 透過網址擷取網誌。
- listByUser
- 擷取網誌清單。