註解:list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
重要事項:我們將於 2024 年 9 月 30 日停止支援 2.0 JSON API。為確保能持續運作,請將採用 2.0 JSON API 版本的應用程式更新至最新版 API。如需最新版本,請使用左側導覽列中的連結。
擷取貼文的留言清單。立即試用。
如果留言在非公開網誌上,您就必須驗證身分。如果留言位於公開的網誌上,就可以直接呼叫這個方法,而不需驗證。
要求
HTTP 要求
GET https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments
參數
參數名稱 |
值 |
說明 |
必要參數 |
blogId |
string |
要擷取留言的網誌 ID。
|
postId |
string |
要擷取貼文的來源貼文 ID。
|
選用參數 |
fetchBodies |
boolean |
是否包含留言的內文內容。
|
maxResults |
unsigned integer |
要納入結果的留言數量上限。
|
pageToken |
string |
如果要求已分頁,則為接續權杖。 |
startDate |
datetime |
註解的最早擷取日期,為採用 RFC 3339 格式的日期時間。
|
要求主體
請勿使用這個方法提供要求主體。
回應
如果成功的話,這個方法會傳回回應內文,其結構如下:
{
"kind": "blogger#commentList",
"nextPageToken": string,
"prevPageToken": string,
"items": [
comments Resource
]
}
資源名稱 |
值 |
說明 |
附註 |
kind |
string |
此項目的類型。一律為 blogger#commentList 。 |
|
nextPageToken |
string |
用於擷取下一頁的分頁符記 (如果有的話)。 |
|
prevPageToken |
string |
用於擷取上一頁的分頁符記 (如果有的話)。 |
|
items[] |
list |
指定貼文的留言資源清單。 |
|
歡迎試用!
您可以使用下方的檔案總管,針對即時資料呼叫此方法,然後查看回應。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-06-26 (世界標準時間)。
[null,null,["上次更新時間:2024-06-26 (世界標準時間)。"],[[["\u003cp\u003eBlogger API v2.0 will be discontinued on September 30, 2024; migrate to the latest version for continued support.\u003c/p\u003e\n"],["\u003cp\u003eThis endpoint retrieves a list of comments for a specific blog post, requiring authentication only for private blogs.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters allow filtering by date, limiting results, and including comment bodies.\u003c/p\u003e\n"],["\u003cp\u003eResponses include pagination tokens for navigating through results and a list of comment resources.\u003c/p\u003e\n"],["\u003cp\u003eA "Try It!" feature allows users to experiment with the method using live data.\u003c/p\u003e\n"]]],[],null,["# Comments: 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 the list of [Comments](/blogger/docs/2.0/json/reference/comments) for a [Post](/blogger/docs/2.0/json/reference/posts).\n[Try it now](#try-it).\n\nAuthentication is required if the comments are on a blog that is private. If the comments 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/postId/comments\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|--------------------|--------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `blogId` | `string` | ID of the blog to fetch comments from. |\n| `postId` | `string` | ID of the post to fetch posts from. |\n| **Optional Parameters** |||\n| `fetchBodies` | `boolean` | Whether the body content of the comments is included. |\n| `maxResults` | `unsigned integer` | Maximum number of comments to include in the result. |\n| `pageToken` | `string` | Continuation token if request is paged. |\n| `startDate` | `datetime` | Earliest date of comment 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#commentList\",\n \"nextPageToken\": string,\n \"prevPageToken\": string,\n \"items\": [\n comments Resource\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|-----------------|----------|-------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entry. Always `blogger#commentList`. | |\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 Comments Resources for the specified post. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]