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

جرِّب هذه الميزة الآن.

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