التعليقات: قائمة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
استرداد قائمة التعليقات الخاصة بمشاركة
جرِّب الخدمة الآن أو اطّلِع على مثال.
يجب الحصول على تفويض إذا كانت التعليقات على مدونة خاصة. إذا كانت التعليقات على مدونة عامة، فيمكن استدعاء هذه الطريقة بدون إذن.
الطلب
طلب 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();
}
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-09 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a list of comments for a specific blog post, requiring authorization only for private blogs.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of comments by date, content inclusion, maximum results, and status (live, pending, spam, emptied).\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large sets of comments using \u003ccode\u003enextPageToken\u003c/code\u003e and \u003ccode\u003eprevPageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eProvides response data including comment details, author information, and pagination tokens in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eOffers code examples in Java for utilizing the API to fetch and display comments.\u003c/p\u003e\n"]]],[],null,["# Comments: list\n\nRetrieves the list of [comments](/blogger/docs/3.0/reference/comments) for a [post](/blogger/docs/3.0/reference/posts).\n[Try it now](#try-it) or [see an example](#examples).\n\n[Authorization](/blogger/docs/3.0/using#auth) is required if the comments are on a blog that is private. If the comments are on a blog that is public, then this method can be called without authorization.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | The ID of the blog to fetch comments from. |\n| `postId` | `string` | The ID of the post to fetch comments from. |\n| **Optional parameters** |||\n| `endDate` | `datetime` | Latest date of comment to fetch, a date-time with RFC 3339 formatting. |\n| `fetchBodies` | `boolean` | Whether the body content of the comments is included. |\n| `maxResults` | `unsigned integer` | Maximum number of comments to include in the result. |\n| `pageToken` | `string` | Continuation token if request is paged. |\n| `startDate` | `datetime` | Earliest date of comment to fetch, a date-time with RFC 3339 formatting. |\n| `status` | `string` | Acceptable values are: - \"`emptied`\": Comments that have had their content removed - \"`live`\": Comments that are publicly visible - \"`pending`\": Comments that are awaiting administrator approval - \"`spam`\": Comments marked as spam by the administrator |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Admin level detail |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"blogger#commentList\",\n \"nextPageToken\": string,\n \"prevPageToken\": string,\n \"items\": [\n comments Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|-------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entry. Always `blogger#commentList`. | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `prevPageToken` | `string` | Pagination token to fetch the previous page, if one exists. | |\n| `items[]` | `list` | The list of comments resources for the specified post. | |\n\nExamples\n--------\n\n**Note:** The code examples available for this method do not represent all supported programming languages (see the [client libraries page](/blogger/docs/3.0/libraries) for a list of supported languages). \n\n### Java\n\nUses the [Java client library](http://code.google.com/p/google-api-java-client/) \n\n```java\n// The BlogId for the http://buzz.blogger.com/ blog.\nString BUZZ_BLOG_ID = \"2399953\";\n\n// The PostId for a buzz post with comments.\nString BUZZ_POST_ID = \"5310628572012276714\";\n\n// Configure the Java API Client for Installed Native App\nHttpTransport HTTP_TRANSPORT = new NetHttpTransport();\nJsonFactory JSON_FACTORY = new JacksonFactory();\n\n// Configure the Installed App OAuth2 flow.\nCredential credential = OAuth2Native.authorize(HTTP_TRANSPORT,\n\tJSON_FACTORY, new LocalServerReceiver(),\n\tArrays.asList(BloggerScopes.BLOGGER));\n\n// Construct the Blogger API access facade object.\nBlogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)\n\t.setApplicationName(\"Blogger-CommentsList-Snippet/1.0\")\n\t.setHttpRequestInitializer(credential).build();\n\n// The request action.\nList commentsListAction = blogger.comments().list(BUZZ_BLOG_ID, BUZZ_POST_ID);\n\n// Restrict the result content to just the data we need.\ncommentsListAction.setFields(\"items(author/displayName,content),nextPageToken\");\n\n// This step sends the request to the server.\nCommentList comments = commentsListAction.execute();\n\n// Now we can navigate the response.\nwhile(comments.getItems() != null && !comments.getItems().isEmpty()){\n\tfor(Comment comment : comments.getItems()) {\n\t\tSystem.out.println(comment.getAuthor().getDisplayName()+\": \"+comment.getContent());\n\t}\n\n\t// Pagination logic\n\tString pageToken = comments.getNextPageToken();\n\tif(pageToken == null) {\n\t\tbreak;\n\t}\n\tSystem.out.println(\"-- Next page of comments\");\n\tcommentsListAction.setPageToken(pageToken);\n\tcomments = commentsListAction.execute();\n}\n```\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]