貼文
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
文章資源包含網誌文章的 HTML 內容,以及文章中繼資料。
如需本資源的方法清單,請見本頁結尾。
資源表示法
{
"kind": "blogger#post",
"id": string,
"blog": {
"id": string
},
"published": datetime,
"updated": datetime,
"url": string,
"selfLink": string,
"title": string,
"titleLink": string,
"content": string,
"images": [
{
"url": string
}
],
"author": {
"id": string,
"displayName": string,
"url": string,
"image": {
"url": string
}
},
"replies": {
"totalItems": long,
"selfLink": string,
"items": [
comments Resource
]
},
"labels": [
string
],
"location": {
"name": string,
"lat": double,
"lng": double,
"span": string
},
"status": string
}
屬性名稱 |
值 |
說明 |
附註 |
kind |
string |
這個實體的類型。一律為 blogger#post 。 |
|
id |
string |
這個貼文的 ID。 |
|
blog |
object |
包含這篇文章的網誌相關資料。 |
|
blog.id |
string |
包含這則貼文的網誌 ID。 |
|
published |
datetime |
RFC 3339 date-time 這篇文章發布時的時間。 |
|
updated |
datetime |
RFC 3339 date-time 上次更新這篇文章的時間。 |
|
url |
string |
這則貼文的顯示網址。 |
|
selfLink |
string |
要擷取這項資源的 Blogger API 網址。 |
|
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 |
用於擷取這篇文章留言的 Blogger API 網址。 |
|
labels[] |
list |
這篇文章的標籤清單。 |
|
replies.items[] |
list |
這篇貼文的留言清單。 |
|
location |
object |
如果這則貼文有地理標記,則會顯示地點。 |
|
location.name |
string |
地點名稱。 |
|
location.lat |
double |
位置的緯度。 |
|
location.lng |
double |
位置經度。 |
|
location.span |
string |
位置的可視區域跨度。可在算繪地圖預覽畫面時使用。 |
|
titleLink |
string |
標題連結網址,類似於 Atom 的相關連結。 |
|
images[] |
list |
顯示貼文的圖片。 |
|
images[].url |
string |
|
|
status |
string |
貼文狀態。僅限管理員層級要求設定 |
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-05-15 (世界標準時間)。
[null,null,["上次更新時間:2025-05-15 (世界標準時間)。"],[[["\u003cp\u003eA posts resource stores a blog post's HTML content and metadata, such as title, author, and publication date.\u003c/p\u003e\n"],["\u003cp\u003eThe resource representation includes details like post ID, blog ID, content, author information, comments, labels, and location.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage posts using various methods: list to retrieve multiple posts, get to retrieve a specific post by ID, and others for searching, inserting, deleting, updating, and publishing.\u003c/p\u003e\n"],["\u003cp\u003ePosts can include custom metadata and images, along with details about the post's location if it is geotagged.\u003c/p\u003e\n"]]],[],null,["# Posts\n\nA posts resource contain the HTML content of a blog post, along with post metadata.\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```objective-c\n{\n \"kind\": \"blogger#post\",\n \"id\": string,\n \"blog\": {\n \"id\": string\n },\n \"published\": datetime,\n \"updated\": datetime,\n \"url\": string,\n \"selfLink\": string,\n \"title\": string,\n \"titleLink\": string,\n \"content\": string,\n \"images\": [\n {\n \"url\": string\n }\n ],\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 \"items\": [\n comments Resource\n ]\n },\n \"labels\": [\n string\n ],\n \"location\": {\n \"name\": string,\n \"lat\": double,\n \"lng\": double,\n \"span\": string\n },\n \"status\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------------|------------|----------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#post`. | |\n| `id` | `string` | The ID of this post. | |\n| `blog` | `object` | Data about the blog containing this post. | |\n| blog.`id` | `string` | The ID of the blog that contains this post. | |\n| `published` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this post was published. | |\n| `updated` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this post was last updated. | |\n| `url` | `string` | The URL where this post is displayed. | |\n| `selfLink` | `string` | The Blogger API URL to fetch this resource from. | |\n| `title` | `string` | The title of the post. | |\n| `content` | `string` | The content of the post. Can contain HTML markup. | |\n| `author` | `object` | The author of this post. | |\n| author.`id` | `string` | The ID 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 Blogger API URL of to retrieve the comments for this post. | |\n| `labels[]` | `list` | The list of labels this post was tagged with. | |\n| replies.`items[]` | `list` | The list of comments for this post. | |\n| `location` | `object` | The location, if this post is geotagged. | |\n| location.`name` | `string` | Location name. | |\n| location.`lat` | `double` | Location's latitude. | |\n| location.`lng` | `double` | Location's longitude. | |\n| location.`span` | `string` | Location's viewport span. Can be used when rendering a map preview. | |\n| `titleLink` | `string` | The title link URL, similar to atom's related link. | |\n| `images[]` | `list` | Display image for the Post. | |\n| images[].`url` | `string` | | |\n| `status` | `string` | Status of the post. Only set for admin-level requests | |\n\nMethods\n-------\n\nYou can retrieve the list of posts for a blog using the [list](/blogger/docs/3.0/reference/posts/list) method, and retrieve an individual post using the [get](/blogger/docs/3.0/reference/posts/get) method.\n\n[list](/blogger/docs/3.0/reference/posts/list)\n: Retrieves a list of posts.\n\n[get](/blogger/docs/3.0/reference/posts/get)\n: Retrieves one post by post ID.\n\n[search](/blogger/docs/3.0/reference/posts/search)\n: Searches for a post that matches the given query terms.\n\n[insert](/blogger/docs/3.0/reference/posts/insert)\n: Adds a post.\n\n[delete](/blogger/docs/3.0/reference/posts/delete)\n: Deletes a post by ID.\n\n[getByPath](/blogger/docs/3.0/reference/posts/getByPath)\n: Retrieves a post by path.\n\n[patch](/blogger/docs/3.0/reference/posts/patch)\n: Updates a post. This method supports [patch semantics](/blogger/docs/3.0/performance).\n\n[update](/blogger/docs/3.0/reference/posts/update)\n: Updates a post.\n\n[publish](/blogger/docs/3.0/reference/posts/publish)\n: Publish a draft post.\n\n[revert](/blogger/docs/3.0/reference/posts/revert)\n: Revert a published or scheduled post to draft state, which removes the post from the publicly viewable content."]]