貼文
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
重要事項:我們將在 2024 年 9 月 30 日停止支援 JSON API 2.0 版。為確保相關功能持續運作,請將使用 v2.0 JSON API 的應用程式更新為最新的 API 版本。如要使用最新版本,請使用左側的水平列連結。
資源表示法
Posts 資源包含網誌中貼文的資料和中繼資料。
{
"kind": "blogger#post",
"id": long,
"blog": {
"id": long
},
"published": datetime,
"updated": datetime,
"url": string,
"selfLink": string,
"title": string,
"content": string,
"author": {
"id": string,
"displayName": string,
"url": string,
"image": {
"url": string
}
},
"replies": {
"totalItems": long,
"selfLink": string
},
"labels": [
string
]
}
資源名稱 |
值 |
說明 |
附註 |
kind |
string |
這個實體的類型。一律為 blogger#post 。 |
|
id |
long |
這個貼文的 ID。 |
|
blog |
object |
包含這篇文章的網誌相關資料。 |
|
blog.id |
long |
包含這則貼文的網誌 ID。 |
|
published |
datetime |
這篇文章發布時的 RFC 3339 日期時間。 |
|
updated |
datetime |
這篇文章上次更新的 RFC 3339 日期時間。 |
|
url |
string |
這則貼文的顯示網址。 |
|
selfLink |
string |
要擷取這項資源的 API REST 網址。 |
|
title |
string |
貼文標題。 |
|
content |
string |
貼文內容。可能包含 HTML 標記。 |
|
author |
object |
這則貼文的作者。 |
|
author.id |
string |
貼文建立者的 ID。 |
|
author.displayName |
string |
貼文建立者的顯示名稱。 |
|
author.url |
string |
貼文創作者的個人資料頁面網址。 |
|
author.image |
object |
貼文創作者的顯示圖片。 |
|
author.image.url |
string |
貼文建立者的顯示圖片網址。 |
|
replies |
object |
此貼文留言的容器。 |
|
replies.totalItems |
long |
這則貼文的留言總數。 |
|
replies.selfLink |
string |
這篇文章的留言網址。 |
|
labels[] |
list |
這篇文章的標籤清單。 |
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-12-21 (世界標準時間)。
[null,null,["上次更新時間:2024-12-21 (世界標準時間)。"],[[["\u003cp\u003eSupport for the v2.0 JSON API will be discontinued on September 30, 2024, requiring applications to update to the latest API version.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows retrieval of blog posts using the \u003ccode\u003eblogger.posts.list\u003c/code\u003e and \u003ccode\u003eblogger.posts.get\u003c/code\u003e methods, enabling access to post data.\u003c/p\u003e\n"],["\u003cp\u003ePosts contain HTML content and metadata such as title, author information, publication date, and associated labels.\u003c/p\u003e\n"],["\u003cp\u003eThe "Posts Resource" provides a structured representation of a blog post, including details like ID, content, author, and comments.\u003c/p\u003e\n"]]],[],null,["# Posts\n\n**Important**:\nWe will discontinue support for the v2.0 JSON API on September 30th, 2024.\nTo ensure continued functionality, update your applications that rely on the v2.0 JSON API\nto the latest API version. For the latest version, use the links in the left-side navbar.\nPosts contain the HTML content of a blog post.\n\nMethods\n-------\n\nYou can retrieve the list of Posts for a Blog using the [blogger.posts.list](/blogger/docs/2.0/json/reference/posts/list) method, and retrieve an individual Post using the [blogger.posts.get](/blogger/docs/2.0/json/reference/posts/get) method.\n\n[list](/blogger/docs/2.0/json/reference/posts/list)\n: Retrieves a list of posts.\n\n[get](/blogger/docs/2.0/json/reference/posts/get)\n: Retrieves one post by postId.\n\nResource Representations\n------------------------\n\nThe Posts Resource contains the data and metadata for a post in a blog.\n\n```text\n{\n \"kind\": \"blogger#post\",\n \"id\": long,\n \"blog\": {\n \"id\": long\n },\n \"published\": datetime,\n \"updated\": datetime,\n \"url\": string,\n \"selfLink\": string,\n \"title\": string,\n \"content\": string,\n \"author\": {\n \"id\": string,\n \"displayName\": string,\n \"url\": string,\n \"image\": {\n \"url\": string\n }\n },\n \"replies\": {\n \"totalItems\": long,\n \"selfLink\": string\n },\n \"labels\": [\n string\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|----------------------|------------|-----------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#post`. | |\n| `id` | `long` | The identifier of this post. | |\n| `blog` | `object` | Data about the blog containing this post. | |\n| blog.`id` | `long` | The identifier of the blog that contains this post. | |\n| `published` | `datetime` | RFC 3339 date-time when this post was published. | |\n| `updated` | `datetime` | RFC 3339 date-time when this post was last updated. | |\n| `url` | `string` | The URL where this post is displayed. | |\n| `selfLink` | `string` | The API REST URL to fetch this resource from. | |\n| `title` | `string` | The title of the post. | |\n| `content` | `string` | The content of the post. May contain HTML markup. | |\n| `author` | `object` | The author of this post. | |\n| author.`id` | `string` | The identifier of the post creator. | |\n| author.`displayName` | `string` | The post creator's display name. | |\n| author.`url` | `string` | The URL of the post creator's Profile page. | |\n| author.`image` | `object` | The post creator's avatar. | |\n| author.image.`url` | `string` | The post creator's avatar URL. | |\n| `replies` | `object` | The container for this post's comments. | |\n| replies.`totalItems` | `long` | The total number of comments on this post. | |\n| replies.`selfLink` | `string` | The URL of the comments on this post. | |\n| `labels[]` | `list` | The list of labels this post was tagged with. | |"]]