註解：list

擷取貼文的留言清單。 立即試用或查看範例。

如果留言位於私人網誌，就必須授權。如果留言位於公開的網誌中，不必經過授權即可呼叫這個方法。

要求

HTTP 要求

GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments

參數

參數名稱 值 說明
必要參數
blogId string 擷取留言的來源網誌 ID。
postId string 擷取留言的訊息 ID。
選用參數
endDate datetime 要擷取的最近一次註解日期，採用 RFC 3339 格式的日期時間。
fetchBodies boolean 是否包含註解的內文內容。
maxResults unsigned integer 要納入結果的留言數量上限。
pageToken string 要求為分頁的接續權杖。
startDate datetime 擷取的最早留言日期，採用 RFC 3339 格式的日期時間。
status string

可接受的值如下：
  • 「emptied」：已移除其內容的留言
  • "live"：公開顯示的留言
  • "pending"：正在等待管理員核准的留言
  • "spam"：管理員已將垃圾留言標為
view string

可接受的值如下：
  • "ADMIN"：管理員層級詳細資料
  • "AUTHOR"：作者層級詳細資料
  • "READER"：管理員層級詳細資料

要求主體

請不要透過此方法提供請求主體。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "blogger#commentList",
  "nextPageToken": string,
  "prevPageToken": string,
  "items": [
    comments Resource
  ]
}
屬性名稱 值 說明 Notes
kind string 此項目種類。一律為 blogger#commentList。
nextPageToken string 用於擷取下一頁的分頁符記 (如果有的話)。
prevPageToken string 用於擷取上一頁的分頁憑證 (如果有的話)。
items[] list 指定貼文的留言資源清單。

範例

注意：這個方法適用的程式語言眾多，我們只在此提供部分程式碼範例，完整的支援語言清單請參閱用戶端程式庫頁面。

Java

使用 Java 用戶端程式庫

// The BlogId for the http://buzz.blogger.com/ blog.
String BUZZ_BLOG_ID = "2399953";

// The PostId for a buzz post with comments.
String BUZZ_POST_ID = "5310628572012276714";

// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();

// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
	JSON_FACTORY, new LocalServerReceiver(),
	Arrays.asList(BloggerScopes.BLOGGER));

// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
	.setApplicationName("Blogger-CommentsList-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
List commentsListAction = blogger.comments().list(BUZZ_BLOG_ID, BUZZ_POST_ID);

// Restrict the result content to just the data we need.
commentsListAction.setFields("items(author/displayName,content),nextPageToken");

// This step sends the request to the server.
CommentList comments = commentsListAction.execute();

// Now we can navigate the response.
while(comments.getItems() != null && !comments.getItems().isEmpty()){
	for(Comment comment : comments.getItems()) {
		System.out.println(comment.getAuthor().getDisplayName()+": "+comment.getContent());
	}

	// Pagination logic
	String pageToken = comments.getNextPageToken();
	if(pageToken == null) {
		break;
	}
	System.out.println("-- Next page of comments");
	commentsListAction.setPageToken(pageToken);
	comments = commentsListAction.execute();
}

試試看！

使用 APIs Explorer 針對即時資料呼叫這個方法，並查看回應。