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 قائمة المشاركات التي تتضمّن معلومات المستخدمين عن المشاركة في هذه المدونة

جرّب الآن

استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.