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 زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.