PostUserInfos: لیست
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
نیاز به مجوز دارد
فهرستی از جفتهای اطلاعات کاربر پست و پست، احتمالاً فیلتر شده را بازیابی میکند. اطلاعات کاربر پست حاوی اطلاعات هر کاربر در مورد پست، مانند حقوق دسترسی، خاص کاربر است. اکنون آن را امتحان کنید .
درخواست کنید
درخواست HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
پارامترها
نام پارامتر | ارزش | توضیحات |
---|
پارامترهای مورد نیاز |
blogId | string | شناسه وبلاگ برای دریافت پست ها از آن. |
userId | string | شناسه کاربر برای اطلاعات هر کاربر که باید واکشی شود. یا کلمه "خود" (بدون نقل قول) یا شناسه نمایه کاربر. |
پارامترهای اختیاری |
endDate | datetime | آخرین تاریخ ارسال برای واکشی، تاریخ-زمان با قالب بندی RFC 3339. |
fetchBodies | boolean | آیا شامل محتوای بدنه پست می شود. پیش فرض false است. (پیشفرض: false ) |
labels | string | فهرستی از برچسبهای جدا شده با کاما برای جستجو. |
maxResults | unsigned integer | حداکثر تعداد پست برای واکشی |
orderBy | string | ترتیب مرتب سازی اعمال شده در نتایج جستجو. پیش فرض published است.
مقادیر قابل قبول عبارتند از:- "
published ": ترتیب بر اساس تاریخ انتشار پست - "
updated ": بر اساس تاریخ آخرین به روز رسانی پست سفارش دهید
|
pageToken | string | توکن Continuation که برای صفحهبندی مجموعههای نتایج بزرگ استفاده میشود. برای دریافت صفحه بعدی نتایج، این پارامتر را روی مقدار "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 | لیست پست ها با اطلاعات کاربر برای پست، برای این وبلاگ. | |
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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."]]