نظرات: لیست

لیست نظرات یک پست را بازیابی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

اگر نظرات در وبلاگی خصوصی باشد، مجوز لازم است. اگر نظرات در وبلاگی باشد که عمومی است، این روش را می توان بدون مجوز فراخوانی کرد.

درخواست کنید

درخواست 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 فهرست منابع نظرات برای پست مشخص شده.

نمونه ها

توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).

جاوا

از کتابخانه کلاینت جاوا استفاده می کند 

// 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 زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.