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

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

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

الطلب

طلب 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();
}

جرّب الآن

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