Posts:list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
重要事項:我們將於 2024 年 9 月 30 日停止支援 2.0 JSON API。為確保能持續運作,請將採用 2.0 JSON API 版本的應用程式更新至最新版 API。如需最新版本,請使用左側導覽列中的連結。
擷取貼文清單。
立即試用。
如果文章位於不公開的網誌上,必須經過驗證。如果這些文章位於公開的網誌上,您就可以在不驗證的情況下呼叫此方法。
要求
HTTP 要求
GET https://www.googleapis.com/blogger/v2/blogs/blogId/posts
參數
參數名稱 |
值 |
說明 |
必要參數 |
blogId |
string |
要擷取文章的網誌 ID。
|
選用參數 |
fetchBodies |
boolean |
是否包含貼文內文。
|
maxResults |
unsigned integer |
要擷取的訊息數量上限。
|
pageToken |
string |
要求已分頁時的接續權杖。 |
startDate |
datetime |
要擷取的最早張貼日期,採用 RFC 3339 格式的日期時間。
|
要求主體
請勿使用這個方法提供要求主體。
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{
"kind": "blogger#postList",
"nextPageToken": string,
"prevPageToken": string,
"items": [
posts Resource
]
}
資源名稱 |
值 |
說明 |
附註 |
kind |
string |
這個實體的種類。一律為 blogger#postList 。 |
|
nextPageToken |
string |
用於擷取下一頁的分頁符記 (如果有的話)。 |
|
prevPageToken |
string |
用於擷取上一頁的分頁符記 (如果有的話)。 |
|
items[] |
list |
這個網誌的文章清單。 |
|
歡迎試用!
您可以使用下方的檔案總管,針對即時資料呼叫此方法,然後查看回應。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-06-26 (世界標準時間)。
[null,null,["上次更新時間:2024-06-26 (世界標準時間)。"],[[["\u003cp\u003eSupport for the v2.0 JSON API will be discontinued on September 30, 2024, and users should update to the latest API version.\u003c/p\u003e\n"],["\u003cp\u003eThis API retrieves a list of posts from a specified blog, requiring authentication only for private blogs.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use parameters like \u003ccode\u003efetchBodies\u003c/code\u003e, \u003ccode\u003emaxResults\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003estartDate\u003c/code\u003e to customize their requests for retrieving posts.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses will provide a list of posts along with pagination tokens for navigating through results.\u003c/p\u003e\n"]]],[],null,["# Posts: list\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.\n\nRetrieves a list of posts.\n[Try it now](#try-it).\n\nAuthentication is required if the posts are on a blog that is private. If the posts are on a blog that is public, then this method can be called without authentication.\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/blogger/v2/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|--------------------|--------------------------------------------------------------------|\n| **Required Parameters** |||\n| `blogId` | `string` | ID of the blog to fetch posts from. |\n| **Optional Parameters** |||\n| `fetchBodies` | `boolean` | Whether the body content of posts is included. |\n| `maxResults` | `unsigned integer` | Maximum number of posts to fetch. |\n| `pageToken` | `string` | Continuation token if the request is paged. |\n| `startDate` | `datetime` | Earliest post date to fetch, a date-time with RFC 3339 formatting. |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"blogger#postList\",\n \"nextPageToken\": string,\n \"prevPageToken\": string,\n \"items\": [\n posts Resource\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|-----------------|----------|-------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList`. | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `prevPageToken` | `string` | Pagination token to fetch the previous page, if one exists. | |\n| `items[]` | `list` | The list of posts for this blog. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]