博客是 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 方法。
- get
- 根据博客 ID 检索博客。
- getByUrl
- 根据网址检索博客。
- listByUser
- 检索博客列表。