博客
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
博客是 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 |
此博客的博文列表。 |
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-06-26。
[null,null,["最后更新时间 (UTC):2024-06-26。"],[[["\u003cp\u003eA blog in the Blogger API is the primary data structure, containing posts, pages, and associated comments.\u003c/p\u003e\n"],["\u003cp\u003eEach blog has metadata such as title, description, publication date, update date, and locale information.\u003c/p\u003e\n"],["\u003cp\u003eBlogs can be accessed and managed through dedicated API methods like \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003egetByUrl\u003c/code\u003e, and \u003ccode\u003elistByUser\u003c/code\u003e, enabling developers to retrieve individual blogs or lists of blogs associated with a specific user.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides comprehensive access to blog data, including the number of posts and pages, as well as links to access these collections.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage the \u003ccode\u003eposts\u003c/code\u003e and \u003ccode\u003epages\u003c/code\u003e properties to retrieve and interact with a blog's content.\u003c/p\u003e\n"]]],[],null,["# Blogs\n\nA blog is the root data class for the Blogger API. Each blog has a series of [posts](/blogger/docs/3.0/reference/posts) and [pages](/blogger/docs/3.0/reference/pages), and each post has a series of [comments](/blogger/docs/3.0/reference/comments).\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```gdscript\n{\n \"kind\": \"blogger#blog\",\n \"id\": value,\n \"name\": value,\n \"description\": value,\n \"published\": value,\n \"updated\": value,\n \"url\": value,\n \"selfLink\": value,\n \"posts\": {\n \"totalItems\": value,\n \"selfLink\": value\n },\n \"pages\": {\n \"totalItems\": value,\n \"selfLink\": value\n },\n \"locale\": {\n \"language\": value,\n \"country\": value,\n \"variant\": value\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|--------------------|------------|---------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entry. Always `blogger#blog`. | |\n| `id` | `string` | The ID for this resource. | |\n| `name` | `string` | The name of this blog, which is usually displayed in Blogger as the blog's title. The title can include HTML. | |\n| `description` | `string` | The description of this blog, which is usually displayed in Blogger underneath the blog's title. The description can include HTML. | |\n| `published` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this blog was published, for example \"2007-02-09T10:13:10-08:00\". | |\n| `updated` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this blog was last updated, for example \"2012-04-15T19:38:01-07:00\". | |\n| `url` | `string` | The URL where this blog is published. | |\n| `selfLink` | `string` | The Blogger API URL to fetch this resource from. | |\n| `posts` | `object` | The container for this blog's posts. | |\n| posts.`totalItems` | `integer` | The total number of posts on this blog. | |\n| posts.`selfLink` | `string` | The URL of the collection of posts for this blog. | |\n| `pages` | `object` | The container for this blog's pages. | |\n| pages.`totalItems` | `integer` | The total number of pages for this blog. | |\n| pages.`selfLink` | `string` | The URL of the pages collection for this blog. | |\n| `locale` | `object` | The locale this blog is set to, as broken out below. | |\n| locale.`language` | `string` | The language this blog is set to, for example \"en\" for English. | |\n| locale.`country` | `string` | The country variant of the language, for example \"US\" for American English. | |\n| locale.`variant` | `string` | The language variant this blog is set to. | |\n| `customMetaData` | `string` | The JSON custom metadata for the blog | |\n| posts.`items[]` | `list` | The list of posts for this Blog. | |\n\nMethods\n-------\n\nTo retrieve a list of blogs that a given [user](/blogger/docs/3.0/reference/users#resource) has access rights to, use the [blogger.blogs.list](/blogger/docs/3.0/reference/blogs/list) method. To retrieve an individual [blogs](/blogger/docs/3.0/reference/blogs#resource) resource, use the [blogger.blogs.get](/blogger/docs/3.0/reference/blogs/get) method.\n\n[get](/blogger/docs/3.0/reference/blogs/get)\n: Retrieves a blog by its ID.\n\n[getByUrl](/blogger/docs/3.0/reference/blogs/getByUrl)\n: Retrieves a blog by URL.\n\n[listByUser](/blogger/docs/3.0/reference/blogs/listByUser)\n: Retrieves a list of blogs."]]