תגובות: רשימה

מאחזר את רשימת התגובות של פוסט. אפשר לנסות עכשיו או לראות דוגמה.

אם התגובות פורסמו בבלוג פרטי, יש צורך בהרשאה. אם התגובות הן בבלוג ציבורי, אפשר לקרוא לשיטה הזו ללא הרשאה.

שליחת בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים נדרשים
blogId string מזהה הבלוג שממנו יש לאחזר תגובות.
postId string המזהה של הפוסט שממנו יש לאחזר תגובות.
פרמטרים אופציונליים
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
  ]
}
שם הנכס ערך תיאור הערות
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 בהמשך.