PostUserInfos: قائمة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتطلّب تفويضًا
يسترجع قائمة بزوجات معلومات المستخدمين والمشاركات، وقد تكون مفلترة. تحتوي معلومات المستخدم الخاصة بالمنشور على معلومات خاصة بكل مستخدم حول المنشور، مثل حقوق الوصول الخاصة بالمستخدم.
جرِّب ذلك الآن.
الطلب
طلب HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
المعلمات
| اسم المعلَمة |
القيمة |
الوصف |
| المَعلمات المطلوبة |
blogId |
string |
معرّف المدونة التي تريد جلب المشاركات منها.
|
userId |
string |
رقم تعريف المستخدم الذي سيتم جلب معلوماته. إما كلمة self (بدون علامات الاقتباس) أو معرّف الملف الشخصي للمستخدم.
|
| المَعلمات الاختيارية |
endDate |
datetime |
آخر تاريخ لنشر المحتوى المطلوب استرجاعه، وهو تاريخ ووقت بتنسيق RFC 3339.
|
fetchBodies |
boolean |
ما إذا كان سيتم تضمين محتوى نص المشاركة القيمة التلقائية هي false.
(القيمة التلقائية: false)
|
labels |
string |
قائمة مفصولة بفواصل للتصنيفات التي تريد البحث عنها
|
maxResults |
unsigned integer |
الحد الأقصى لعدد المشاركات التي سيتم جلبها
|
orderBy |
string |
ترتيب الترتيب الذي تم تطبيقه على نتائج البحث القيمة التلقائية هي published.
القِيَم المقبولة هي:
- "
published": الترتيب حسب تاريخ نشر المشاركة
- "
updated": الترتيب حسب تاريخ آخر تعديل على المشاركة
|
pageToken |
string |
رمز المتابعة الذي يُستخدَم للتنقّل في مجموعات النتائج الكبيرة. للحصول على الصفحة التالية من النتائج، اضبط هذه المَعلمة على قيمة "nextPageToken" من الاستجابة السابقة.
|
startDate |
datetime |
أقرب تاريخ نشر يمكن استرجاعه، وهو تاريخ ووقت بتنسيق RFC 3339.
|
status |
string |
القِيَم المقبولة هي:
- "
draft": مسودات المشاركات
- "
live": المشاركات المنشورة
- "
scheduled": المشاركات التي تم تحديد موعد نشرها في المستقبل
|
view |
string |
القِيَم المقبولة هي:
- "
ADMIN": تفاصيل على مستوى المشرف
- "
AUTHOR": تفاصيل على مستوى المؤلف
- "
READER": تفاصيل على مستوى القارئ
|
التفويض
يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية (اطّلِع على مزيد من المعلومات عن المصادقة والتفويض).
| النطاق |
|---|
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
نص الطلب
لا تقدِّم محتوى طلب باستخدام هذه الطريقة.
الردّ
في حال نجاح هذه الطريقة، تعرض نص استجابة بالبنية التالية:
{
"kind": "blogger#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos Resource
]
}
| اسم الموقع |
القيمة |
الوصف |
ملاحظات |
kind |
string |
نوع هذا الكيان. blogger#postList دائمًا |
|
nextPageToken |
string |
رمز مخطّط التقسيم لصفحة الويب من أجل جلب الصفحة التالية، في حال توفّرها |
|
items[] |
list |
قائمة المشاركات التي تتضمّن معلومات المستخدمين عن المشاركة في هذه المدونة |
|
جرّب الآن
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-30 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-30 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a list of posts and user-specific information for those posts from a specified blog.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of posts by date, labels, status, and other criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results with post and user information.\u003c/p\u003e\n"],["\u003cp\u003eCan be tested using the provided API Explorer.\u003c/p\u003e\n"]]],[],null,["# PostUserInfos: list\n\n**Requires [authorization](#auth)**\n\nRetrieves a list of post and post user info pairs, possibly filtered. The post user info contains per-user information about the post, such as access rights, specific to the user.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | ID of the blog to fetch posts from. |\n| `userId` | `string` | ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier. |\n| **Optional parameters** |||\n| `endDate` | `datetime` | Latest post date to fetch, a date-time with RFC 3339 formatting. |\n| `fetchBodies` | `boolean` | Whether to include the post's body content. Default is `false`. (Default: `false`) |\n| `labels` | `string` | Comma-separated list of labels to search for. |\n| `maxResults` | `unsigned integer` | Maximum number of posts to fetch. |\n| `orderBy` | `string` | Sort order applied to search results. Default is `published`. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`published`\": Order by the date the post was published - \"`updated`\": Order by the date the post was last updated |\n| `pageToken` | `string` | The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of \"nextPageToken\" from the previous response. |\n| `startDate` | `datetime` | Earliest post date to fetch, a date-time with RFC 3339 formatting. |\n| `status` | `string` | Acceptable values are: - \"`draft`\": Draft posts - \"`live`\": Published posts - \"`scheduled`\": Posts that are scheduled to publish in future. |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Reader level detail |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/blogger/docs/3.0/using#auth)).\n\n| Scope |\n|----------------------------------------------------|\n| `https://www.googleapis.com/auth/blogger` |\n| `https://www.googleapis.com/auth/blogger.readonly` |\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#postUserInfosList\",\n \"nextPageToken\": string,\n \"items\": [\n postUserInfos Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|----------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList` | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `items[]` | `list` | The list of Posts with User information for the post, for this Blog. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
