PostUserInfos: lista
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Requer autorização
Recupera uma lista de pares de postagens e informações do usuário, possivelmente filtrada. As informações do usuário da postagem contêm informações sobre a postagem por usuário, como direitos de acesso específicos para o usuário.
Faça o teste agora.
Solicitação
Solicitação HTTP
GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts
Parâmetros
| Nome do parâmetro |
Valor |
Descrição |
| Parâmetros obrigatórios |
blogId |
string |
ID do blog de onde as postagens serão extraídas.
|
userId |
string |
ID do usuário para as informações por usuário serem buscadas. A palavra "self" (sem aspas) ou o identificador do perfil do usuário.
|
| Parâmetros opcionais |
endDate |
datetime |
A data da postagem mais recente a ser extraída, uma data/hora com formatação RFC 3339.
|
fetchBodies |
boolean |
Define se o conteúdo do corpo da postagem será incluído. O padrão é false.
(Padrão: false)
|
labels |
string |
Lista de rótulos separados por vírgulas para pesquisar.
|
maxResults |
unsigned integer |
Número máximo de postagens a serem buscadas.
|
orderBy |
string |
Ordem de classificação aplicada aos resultados da pesquisa. O padrão é published.
Os valores aceitáveis são:
- "
published": ordenar pela data de publicação da postagem
- "
updated": ordenar pela data da última atualização da postagem
|
pageToken |
string |
O token de continuação, usado para percorrer grandes conjuntos de resultados. Para acessar a próxima página de resultados, defina esse parâmetro como o valor de "nextPageToken" da resposta anterior.
|
startDate |
datetime |
A data mais antiga da postagem a ser extraída, uma data/hora com formatação RFC 3339.
|
status |
string |
Os valores aceitáveis são:
- "
draft": rascunhos de publicações
- "
live": postagens publicadas
- "
scheduled": postagens programadas para serem publicadas no futuro.
|
view |
string |
Os valores aceitáveis são:
- "
ADMIN": detalhes no nível do administrador
- "
AUTHOR": detalhes no nível do autor
- "
READER": detalhes do nível do leitor
|
Autorização
Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).
| Escopo |
|---|
https://www.googleapis.com/auth/blogger |
https://www.googleapis.com/auth/blogger.readonly |
Corpo da solicitação
Não forneça um corpo de solicitação com este método.
Resposta
Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:
{
"kind": "blogger#postUserInfosList",
"nextPageToken": string,
"items": [
postUserInfos Resource
]
}
| Nome da propriedade |
Valor |
Descrição |
Observações |
kind |
string |
O tipo desta entidade. Sempre blogger#postList |
|
nextPageToken |
string |
Token de paginação para buscar a próxima página, se houver uma. |
|
items[] |
list |
A lista de postagens com informações do usuário para a postagem, para este blog. |
|
Confira!
Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-30 UTC.
[null,null,["Última atualização 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."]]
