PostUserInfos: Liste
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Autorisierung erforderlich
Ruft eine Liste von Paaren aus Beitrags- und Nutzerinformationen ab, möglicherweise gefiltert. Die Nutzerinformationen zum Beitrag enthalten nutzerspezifische Informationen zum Beitrag, z. B. nutzerspezifische Zugriffsrechte.
Jetzt testen
Anfrage
HTTP-Anfrage
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Parameter
| Parametername |
Wert |
Beschreibung |
| Erforderliche Parameter |
blogId |
string |
ID des Blogs, von dem Beiträge abgerufen werden sollen.
|
userId |
string |
ID des Nutzers, für den die nutzerbezogenen Informationen abgerufen werden sollen. Entweder das Wort „self“ (ohne Anführungszeichen) oder die Profil-ID des Nutzers.
|
| Optionale Parameter |
endDate |
datetime |
Das Datum des letzten abzurufenden Beitrags, ein Datum und eine Uhrzeit im RFC 3339-Format.
|
fetchBodies |
boolean |
Ob der Textkörper des Beitrags eingeschlossen werden soll. Standardwert ist false.
(Standard: false)
|
labels |
string |
Durch Kommas getrennte Liste der Labels, nach denen gesucht werden soll.
|
maxResults |
unsigned integer |
Maximale Anzahl der abzurufenden Beiträge.
|
orderBy |
string |
Sortierung, die auf Suchergebnisse angewendet wird. Standardwert ist published.
Zulässige Werte sind:
- „
published“: Nach dem Datum der Veröffentlichung des Beitrags sortieren
- „
updated“: Sortiert nach dem Datum, an dem der Beitrag zuletzt aktualisiert wurde
|
pageToken |
string |
Das Fortsetzungstoken wird zum Durchsuchen großer Ergebnissätze verwendet. Wenn Sie die nächste Ergebnisseite abrufen möchten, legen Sie für diesen Parameter den Wert „nextPageToken“ aus der vorherigen Antwort fest.
|
startDate |
datetime |
Das Datum des frühesten Beitrags, der abgerufen werden soll, als Datum und Uhrzeit im RFC 3339-Format.
|
status |
string |
Zulässige Werte sind:
- „
draft“: Beitragsentwürfe
- „
live“: Veröffentlichte Beiträge
- „
scheduled“: Beiträge, die in Zukunft veröffentlicht werden sollen.
|
view |
string |
Zulässige Werte sind:
- „
ADMIN“: Detaillierte Informationen auf Administratorebene
- „
AUTHOR“: Details auf Autorebene
- „
READER“: Detailebene für Leser
|
Autorisierung
Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).
| Bereich |
|---|
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{
"kind": "blogger#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos Resource
]
}
| Name der Eigenschaft |
Wert |
Beschreibung |
Hinweise |
kind |
string |
Die Art dieser Entität. Immer blogger#postList |
|
nextPageToken |
string |
Paginierungstoken zum Abrufen der nächsten Seite, falls vorhanden. |
|
items[] |
list |
Die Liste der Beiträge mit Nutzerinformationen für den Beitrag in diesem Blog. |
|
Testen!
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-11-30 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
