Postagens: lista

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

A autorização é necessária se as postagens estiverem em um blog privado. 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 no qual buscar as postagens.
Parâmetros opcionais
endDate datetime Data da postagem mais recente a ser buscada, um date-time com formatação RFC 3339.
fetchBodies boolean Indica se o conteúdo do corpo das postagens é incluído (padrão: verdadeiro). Deve ser definido como falso quando os corpos dos postos não são necessários, para ajudar a minimizar o tráfego. Padrão: true.
fetchImages boolean Se os metadados do URL da imagem de cada postagem estão incluídos.
labels string Lista separada por vírgulas de marcadores para pesquisar.
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": classificar pela data de publicação da postagem
  • "updated": classificar pela data da última atualização da postagem
sortOption string UNAVAILABLE NOW

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

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

Os valores aceitáveis são:
  • "draft": rascunhos de postagens
  • "live": postagens publicadas
  • "scheduled": postagens que estão 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 no 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 da entidade. Sempre blogger#postList.
nextPageToken string Token de paginação para buscar a próxima página, se houver.
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.