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 الرمز المميز للمتابعة، الذي يُستخدم للتنقل عبر مجموعات النتائج الكبيرة. للحصول على الصفحة التالية من النتائج، عيِّن هذه المعلمة على قيمة "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
  ]
}
اسم الموقع القيمة الوصف Notes
kind string نوع هذا الكيان. دائمًا blogger#postList
nextPageToken string الرمز المميّز للتقسيم على صفحات لجلب الصفحة التالية، إن توفّر.
items[] list قائمة المشاركات التي تتضمن معلومات المستخدم للمشاركة في هذه المدونة.

تجربة

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