PostUserInfos: lista
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Requiere autorización
Recupera una lista de pares de publicaciones y de información del usuario de la publicación, posiblemente filtrada. La información del usuario de la publicación contiene información por usuario sobre la publicación, como los derechos de acceso específicos del usuario.
Pruébalo ahora.
Solicitud
Solicitud HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Parámetros
| Nombre del parámetro |
Valor |
Descripción |
| Parámetros obligatorios |
blogId |
string |
Es el ID del blog del que se recuperarán las publicaciones.
|
userId |
string |
Es el ID del usuario para el que se recuperará la información por usuario. La palabra "self" (sin comillas) o el identificador de perfil del usuario
|
| Parámetros opcionales |
endDate |
datetime |
Es la fecha de la publicación más reciente que se recuperará, una fecha y hora con el formato RFC 3339.
|
fetchBodies |
boolean |
Indica si se debe incluir el contenido del cuerpo de la publicación. El valor predeterminado es false.
(Predeterminado: false)
|
labels |
string |
Es una lista de etiquetas separadas por comas que se deben buscar.
|
maxResults |
unsigned integer |
Es la cantidad máxima de publicaciones que se recuperarán.
|
orderBy |
string |
Es el orden de clasificación aplicado a los resultados de la búsqueda. El valor predeterminado es published.
Los valores aceptables son los siguientes:
- "
published": Ordena por la fecha en que se publicó la publicación
- "
updated": Ordena por la fecha en la que se actualizó la publicación por última vez.
|
pageToken |
string |
Es el token de Continuation, que se usa para desplazarse por grandes conjuntos de resultados. Para obtener la siguiente página de resultados, establece este parámetro en el valor de "nextPageToken" de la respuesta anterior.
|
startDate |
datetime |
Es la fecha de la publicación más antigua que se recuperará, una fecha y hora con el formato RFC 3339.
|
status |
string |
Los valores aceptables son los siguientes:
- "
draft": Borradores de publicaciones
- "
live": Publicaciones publicadas
- "
scheduled": Son las publicaciones programadas para publicarse en el futuro.
|
view |
string |
Los valores aceptables son los siguientes:
- "
ADMIN": Detalles a nivel del administrador
- "
AUTHOR": Detalles a nivel del autor
- "
READER": Detalles a nivel del lector
|
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).
| Alcance |
|---|
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
Cuerpo de la solicitud
No proporciones un cuerpo de la solicitud con este método.
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:
{
"kind": "blogger#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos Resource
]
}
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
kind |
string |
Es el tipo de esta entidad. Siempre blogger#postList |
|
nextPageToken |
string |
Es un token de paginación para recuperar la siguiente página, si existe una. |
|
items[] |
list |
Es la lista de publicaciones con la información del usuario de la publicación de este blog. |
|
Pruébalo
Usa el Explorador de APIs que aparece a continuación para llamar a este método en datos en vivo y ver la respuesta.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-11-30 (UTC)
[null,null,["Última actualización: 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."]]
