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

גוף הבקשה

אין לספק גוף בקשה בשיטה הזו.

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר גוף תגובה עם המבנה הבא:

{
  "kind": "blogger#postUserInfosList",
  "nextPageToken": string,
  "items": [
    postUserInfos Resource
  ]
}
שם הנכס ערך תיאור הערות
kind string הסוג של הישות. תמיד blogger#postList
nextPageToken string אסימון עימוד כדי לאחזר את הדף הבא, אם קיים כזה.
items[] list רשימת הפוסטים עם פרטי המשתמש של הפוסט, בבלוג הזה.

נסה בעצמך!

אפשר להשתמש ב-API Explorer שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.