PostUserInfos: liste
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Autorisation requise
Récupère une liste de paires de posts et d'informations sur l'utilisateur du post, éventuellement filtrée. Les informations utilisateur du post contiennent des informations par utilisateur sur le post, telles que les droits d'accès, qui sont spécifiques à l'utilisateur.
Essayer maintenant
Requête
Requête HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Paramètres
| Nom du paramètre |
Valeur |
Description |
| Paramètres obligatoires |
blogId |
string |
ID du blog à partir duquel récupérer les posts.
|
userId |
string |
ID de l'utilisateur pour les informations par utilisateur à extraire. Le mot "self" (sans guillemets) ou l'identifiant de profil de l'utilisateur.
|
| Paramètres facultatifs |
endDate |
datetime |
Date de la dernière publication à extraire, au format date-heure RFC 3339.
|
fetchBodies |
boolean |
Indique si le contenu du corps du post doit être inclus. La valeur par défaut est false.
(Par défaut: false)
|
labels |
string |
Liste d'étiquettes à rechercher, séparées par une virgule.
|
maxResults |
unsigned integer |
Nombre maximal d'articles à extraire.
|
orderBy |
string |
Ordre de tri appliqué aux résultats de recherche. La valeur par défaut est published.
Les valeurs acceptées sont les suivantes :
- "
published": triez les posts par date de publication.
- "
updated": triez par date de la dernière mise à jour du post.
|
pageToken |
string |
Jeton de continuation permettant de parcourir les ensembles de résultats volumineux. Pour obtenir la page de résultats suivante, définissez ce paramètre sur la valeur de "nextPageToken" de la réponse précédente.
|
startDate |
datetime |
Date de publication la plus ancienne à extraire, au format date-heure RFC 3339.
|
status |
string |
Les valeurs acceptées sont les suivantes :
- "
draft": posts en brouillon
- "
live": posts publiés
- "
scheduled": posts programmés pour être publiés à l'avenir.
|
view |
string |
Les valeurs acceptées sont les suivantes :
- "
ADMIN": informations au niveau de l'administrateur
- "
AUTHOR": détails au niveau de l'auteur
- "
READER": détails au niveau du lecteur
|
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation
| Champ d'application |
|---|
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{
"kind": "blogger#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos Resource
]
}
| Nom de propriété |
Valeur |
Description |
Remarques |
kind |
string |
Genre de cette entité. Toujours blogger#postList |
|
nextPageToken |
string |
Jeton de pagination permettant d'extraire la page suivante, le cas échéant. |
|
items[] |
list |
Liste des posts avec les informations utilisateur pour le post, pour ce blog. |
|
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/11/30 (UTC).
[null,null,["Dernière mise à jour le 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."]]
