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

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

נדרש אישור אם התגובות הן בבלוג פרטי. אם התגובות מופיעות בבלוג שגלוי לכולם, אפשר לקרוא לשיטה הזו בלי הרשאה.

בקשה

בקשת 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	רשימת משאבי התגובות לפוסט שצוין.

דוגמאות

הערה: דוגמאות הקוד שזמינות ל-method לא מייצגות את כל שפות התכנות שיש בהן תמיכה. (לרשימת השפות הנתמכות בדף של ספריות הלקוח)

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 שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.