التعليقات: listByBlog
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
استرداد التعليقات الخاصة بالمدونة، عبر كل المشاركات، مع احتمالية تصفيتها.
تجربة ذلك الآن
الطلب
طلب HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/comments
المعلمات
| اسم المعلَمة |
القيمة |
الوصف |
| المَعلمات المطلوبة |
blogId |
string |
معرّف المدونة التي تريد جلب التعليقات منها.
|
| المَعلمات الاختيارية |
endDate |
datetime |
أحدث تاريخ للتعليق المطلوب جلبه، وهو تاريخ ووقت بتنسيق RFC 3339.
|
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\u003eRetrieves all comments for a specified blog, optionally filtered by date and other criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include \u003ccode\u003eblogId\u003c/code\u003e (required), and optional filters like \u003ccode\u003eendDate\u003c/code\u003e, \u003ccode\u003efetchBodies\u003c/code\u003e, \u003ccode\u003emaxResults\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003estartDate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of comments, along with pagination tokens (\u003ccode\u003enextPageToken\u003c/code\u003e, \u003ccode\u003eprevPageToken\u003c/code\u003e) for navigating through results.\u003c/p\u003e\n"],["\u003cp\u003eThis method uses an HTTP GET request to the endpoint \u003ccode\u003ehttps://www.googleapis.com/blogger/v3/blogs/blogId/comments\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Comments: listByBlog\n\nRetrieves the comments for a blog, across all posts, possibly filtered.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/blogs/blogId/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| **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\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 for a Post. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
