التعليقات: قائمة

لاسترداد قائمة التعليقات لمشاركة معيّنة. جرِّب الآن أو شاهد مثالاً.

يكون التفويض مطلوبًا إذا كانت التعليقات على مدونة خاصة. إذا كانت التعليقات منشورة على مدونة عامة، يمكن استدعاء هذه الطريقة بدون تصريح.

طلب

طلب 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

استخدام مكتبة عميل جافا

// 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();

}

جرِّب هذه الميزة الآن.

استخدم مستكشف واجهات برمجة التطبيقات أدناه لاستدعاء هذه الطريقة في البيانات المباشرة والاطلاع على الاستجابة.