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

يستردّ هذا الإجراء قائمة التعليقات على مشاركة. جرِّب الميزة الآن أو اطّلِع على مثال.

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

طلب

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

جرِّبها الآن.

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