لیست نظرات یک پست را بازیابی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
اگر نظرات در وبلاگی خصوصی باشد، مجوز لازم است. اگر نظرات در وبلاگی باشد که عمومی است، این روش را می توان بدون مجوز فراخوانی کرد.
درخواست کنید
درخواست 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 | مقادیر قابل قبول عبارتند از:
|
view | string | مقادیر قابل قبول عبارتند از:
|
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{ "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 زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.