Postagens: lista

Recupera uma lista de postagens. Faça um teste agora ou veja um exemplo.

A autorização será necessária se as postagens estiverem em um blog particular. Se as postagens estiverem em um blog público, esse método poderá ser chamado sem autorização.

Solicitação

Solicitação HTTP

GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros obrigatórios
blogId string O ID do blog a partir do qual as postagens serão buscadas.
Parâmetros opcionais
endDate datetime Data da postagem mais recente a ser buscada, um date-time com formatação RFC 3339.
fetchBodies boolean Se o conteúdo do corpo das postagens está incluído (padrão: true). Ele deve ser definido como falso quando os corpos da postagem não forem necessários para ajudar a minimizar o tráfego. Padrão: true.
fetchImages boolean Se os metadados do URL de imagem de cada postagem estão incluídos.
labels string Lista de identificadores separados por vírgulas para pesquisa.
maxResults unsigned integer Número máximo de postagens a serem buscadas.
orderBy string Ordem de classificação aplicada aos resultados.

Os valores aceitáveis são:
  • "published": ordena pela data de publicação da postagem
  • "updated": ordena pela data da última atualização
sortOption string UNAVAILABLE NOW

Direção de classificação aplicada aos resultados.

Os valores aceitáveis são os seguintes:
  • "descending": classifique as postagens em ordem decrescente de tempo (padrão)
  • "ascending": classifique as postagens em ordem crescente
pageToken string Token de continuação se a solicitação for paginada.
startDate datetime Data mais antiga da postagem a ser buscada, um date-time com formatação RFC 3339.
status string

Os valores aceitáveis são:
  • "draft": postagens de rascunho
  • "live": postagens publicadas
  • "scheduled": postagens que estão programadas para serem publicadas no futuro.
view string

Os valores aceitáveis são:
  • "ADMIN": detalhe do nível de administrador
  • "AUTHOR": detalhe do nível do autor
  • "READER": detalhe do nível do leitor

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#postList",
  "nextPageToken": string,
  "items": [
    posts 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 deste blog.

Exemplos

Observação: os exemplos de código disponíveis para esse método não representam todas as linguagens de programação compatíveis. Consulte a página de bibliotecas cliente para ver uma lista de linguagens compatíveis.

Java

Usa a biblioteca cliente de Java

// The BlogId for the Blogger Buzz blog
String BUZZ_BLOG_ID = "2399953";

// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();

// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
	JSON_FACTORY, new LocalServerReceiver(),
	Arrays.asList(BloggerScopes.BLOGGER));

// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
	.setApplicationName("Blogger-PostsList-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
List postsListAction = blogger.posts().list(BUZZ_BLOG_ID);

// Restrict the result content to just the data we need.
postsListAction.setFields("items(author/displayName,content,published,title,url),nextPageToken");

// This step sends the request to the server.
PostList posts = postsListAction.execute();

// Now we can navigate the response.
int postCount = 0;
int pageCount = 0;
while (posts.getItems() != null && !posts.getItems().isEmpty()) {
	for (Post post : posts.getItems()) {
		System.out.println("Post #"+ ++postCount);
		System.out.println("\tTitle: "+post.getTitle());
		System.out.println("\tAuthor: "+post.getAuthor().getDisplayName());
		System.out.println("\tPublished: "+post.getPublished());
		System.out.println("\tURL: "+post.getUrl());
		System.out.println("\tContent: "+post.getContent());
	}

	// Pagination logic
	String pageToken = posts.getNextPageToken();
	if (pageToken == null || ++pageCount >= 5) {
		break;
	}
	System.out.println("-- Next page of posts");
	postsListAction.setPageToken(pageToken);
	posts = postsListAction.execute();
}

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.