נדרשת הרשאה
מאחזר רשימה של צמדי מידע על משתמשים ופוסטים, שעשויים להיות מסוננים. פרטי המשתמש בפוסט כוללים מידע לכל משתמש על הפוסט, כגון זכויות גישה, ספציפי למשתמש. כדאי לנסות עכשיו.
שליחת בקשה
בקשת 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 .
הערכים הקבילים הם:
|
pageToken |
string |
אסימון המשך, שמשמש לדפדוף בקבוצות של תוצאות גדולות. כדי לקבל את דף התוצאות הבא, צריך להגדיר לפרמטר הזה את הערך "nextPageToken" מהתגובה הקודמת. |
startDate |
datetime |
התאריך המוקדם ביותר לאחזור, תאריך ושעה בפורמט RFC 3339. |
status |
string |
הערכים הקבילים הם:
|
view |
string |
הערכים הקבילים הם:
|
הרשאה
לבקשה הזו נדרשת הרשאה עם לפחות אחד מהיקפי ההרשאות הבאים (מידע נוסף על אימות והרשאה).
היקף ההרשאות |
---|
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 בהמשך.