التعليقات: قائمة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملاحظة مهمة:
سنتوقف عن إتاحة الإصدار 2.0 JSON API في 30 أيلول (سبتمبر) 2024.
لضمان استمرار عمل الوظائف، عليك تحديث تطبيقاتك التي تعتمد على الإصدار 2.0 JSON API
إلى أحدث إصدار من واجهة برمجة التطبيقات. للحصول على أحدث إصدار، استخدِم الروابط في شريط التنقّل الأيمن.
لاسترداد قائمة التعليقات على مشاركة.
التجربة الآن
يجب المصادقة إذا كانت التعليقات على مدونة خاصة. إذا كانت التعليقات على مدونة عامة، فيمكن عندئذٍ استدعاء هذه الطريقة بدون مصادقة.
الطلب
طلب HTTP
GET https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments
المَعلمات
| اسم المعلّمة |
القيمة |
الوصف |
| المَعلمات المطلوبة |
blogId |
string |
رقم تعريف المدونة المطلوب جلب التعليقات منها.
|
postId |
string |
رقم تعريف المشاركة المطلوب جلب المشاركات منها.
|
| المَعلمات الاختيارية |
fetchBodies |
boolean |
ما إذا كان يتم تضمين المحتوى الأساسي للتعليقات
|
maxResults |
unsigned integer |
الحدّ الأقصى لعدد التعليقات التي يمكن تضمينها في النتيجة
|
pageToken |
string |
الرمز المميّز للمتابعة إذا تمت ترقية الطلب إلى صفحات.
|
startDate |
datetime |
أقرب تاريخ للتعليق لجلب التعليق، وهو تاريخ ووقت بتنسيق RFC 3339.
|
نص الطلب
لا توفِّر نص طلب بهذه الطريقة.
الإجابة
إذا نجحت هذه الطريقة، ستعرض هذه الطريقة نص استجابة بالبنية التالية:
{
"kind": "blogger#commentList",
"nextPageToken": string,
"prevPageToken": string,
"items": [
comments Resource
]
}
| اسم الموقع |
القيمة |
الوصف |
Notes |
kind |
string |
نوع هذا الإدخال. blogger#commentList دائمًا. |
|
nextPageToken |
string |
الرمز المميّز لتقسيم النتائج على عدّة صفحات لجلب الصفحة التالية، في حال توفّرها. |
|
prevPageToken |
string |
الرمز المميّز لتقسيم النتائج على عدّة صفحات لجلب الصفحة السابقة، في حال توفّرها. |
|
items[] |
list |
قائمة "موارد التعليقات" للمشاركة المحدّدة. |
|
جرِّبها
استخدِم أداة المستكشف أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-06-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-06-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eBlogger API v2.0 will be discontinued on September 30, 2024; migrate to the latest version for continued support.\u003c/p\u003e\n"],["\u003cp\u003eThis endpoint retrieves a list of comments for a specific blog post, requiring authentication only for private blogs.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters allow filtering by date, limiting results, and including comment bodies.\u003c/p\u003e\n"],["\u003cp\u003eResponses include pagination tokens for navigating through results and a list of comment resources.\u003c/p\u003e\n"],["\u003cp\u003eA "Try It!" feature allows users to experiment with the method using live data.\u003c/p\u003e\n"]]],[],null,["# Comments: list\n\n**Important**:\nWe will discontinue support for the v2.0 JSON API on September 30th, 2024.\nTo ensure continued functionality, update your applications that rely on the v2.0 JSON API\nto the latest API version. For the latest version, use the links in the left-side navbar.\n\nRetrieves the list of [Comments](/blogger/docs/2.0/json/reference/comments) for a [Post](/blogger/docs/2.0/json/reference/posts).\n[Try it now](#try-it).\n\nAuthentication 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 authentication.\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|--------------------|--------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `blogId` | `string` | ID of the blog to fetch comments from. |\n| `postId` | `string` | ID of the post to fetch posts from. |\n| **Optional Parameters** |||\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\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\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]
