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 שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-11-30 (שעון UTC).
[null,null,["עדכון אחרון: 2024-11-30 (שעון UTC)."],[[["\u003cp\u003eRetrieves a list of posts and user-specific information for those posts from a specified blog.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of posts by date, labels, status, and other criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns paginated results with post and user information.\u003c/p\u003e\n"],["\u003cp\u003eCan be tested using the provided API Explorer.\u003c/p\u003e\n"]]],[],null,["# PostUserInfos: list\n\n**Requires [authorization](#auth)**\n\nRetrieves a list of post and post user info pairs, possibly filtered. The post user info contains per-user information about the post, such as access rights, specific to the user.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | ID of the blog to fetch posts from. |\n| `userId` | `string` | ID of the user for the per-user information to be fetched. Either the word 'self' (sans quote marks) or the user's profile identifier. |\n| **Optional parameters** |||\n| `endDate` | `datetime` | Latest post date to fetch, a date-time with RFC 3339 formatting. |\n| `fetchBodies` | `boolean` | Whether to include the post's body content. Default is `false`. (Default: `false`) |\n| `labels` | `string` | Comma-separated list of labels to search for. |\n| `maxResults` | `unsigned integer` | Maximum number of posts to fetch. |\n| `orderBy` | `string` | Sort order applied to search results. Default is `published`. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`published`\": Order by the date the post was published - \"`updated`\": Order by the date the post was last updated |\n| `pageToken` | `string` | The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of \"nextPageToken\" from the previous response. |\n| `startDate` | `datetime` | Earliest post date to fetch, a date-time with RFC 3339 formatting. |\n| `status` | `string` | Acceptable values are: - \"`draft`\": Draft posts - \"`live`\": Published posts - \"`scheduled`\": Posts that are scheduled to publish in future. |\n| `view` | `string` | Acceptable values are: - \"`ADMIN`\": Admin level detail - \"`AUTHOR`\": Author level detail - \"`READER`\": Reader level detail |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/blogger/docs/3.0/using#auth)).\n\n| Scope |\n|----------------------------------------------------|\n| `https://www.googleapis.com/auth/blogger` |\n| `https://www.googleapis.com/auth/blogger.readonly` |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"blogger#postUserInfosList\",\n \"nextPageToken\": string,\n \"items\": [\n postUserInfos Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|----------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList` | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `items[]` | `list` | The list of Posts with User information for the post, for this Blog. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
