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 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 de onde as postagens serão buscadas.
Parâmetros opcionais
endDate datetime A 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 está incluído (padrão: verdadeiro). Isso precisa ser definido como "false" quando os corpos das postagens 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 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.

Os valores aceitáveis são:
  • "published": ordena pela data de publicação da postagem
  • "updated": ordena 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:
  • "descending": ordena as postagens em ordem decrescente de tempo (padrão)
  • "ascending": ordena as postagens em ordem crescente de tempo
pageToken string Token de continuação se a solicitação for paginada.
startDate datetime A 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": postagens em rascunho
  • "live": postagens publicadas
  • "scheduled": postagens programadas para publicação no futuro.
view string

Os valores aceitáveis são:
  • "ADMIN": detalhe no nível de 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,
  &quo}t;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.
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 = "23999
53";
// Configure the Java API Client for Installed 
Native AppHttpTransport HTTP_TRANSPORT = new NetHttpTr
ansport();JsonFactory JSON_FACTORY = new Jackson
Factory();
// Configure the Installed App OA
uth2 flow.Credential credential = OAuth2Native.authorize(HTTP_
TRANSPORT,	JSON_FACTORY, new LocalServerR
eceiver(),	Arrays.asList(BloggerScopes.
BLOGGER));
// Construct the Blogger API access faca
de object.Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSO
N_FACTORY)	.setApplicationName("Blogger-PostsLis
t-Snippet/1.0")	.setHttpRequestInitializer(
credential).build();
//
 The request action.List postsListAction = blogger.posts()
.list(BUZZ_BLOG_ID);
// Restrict the result content to ju
st the data we need.postsListAction.setFields("items(author/displayName,content,published,ti
tle,url),nextPageToken");
// This step se
nds the request to the server.PostList post
s = postsListAction.execute();
// Now
 we can navigate t
he response.int po
stCount = 0;int pageCount = 0;wh&&ile (posts.getItems() != null {
 !posts.getItems().isEmpty()) 	for ({
Post post : posts.getItems()) 		System.out.p
rintln("Post #"+ ++postCount);		System.o
ut.println("\tTitle: "+post.getTitle());		System.out.printl
n("\tAuthor: "+post.getAuthor().getDisplayName()
);		System.out.println("\tPublished: &quo
t;+post.getPublished());		System.out.println("\tU
R}
L: "+post.getUrl
());		System.out.println("\tContent: &qu
ot;+post.getContent());	
	// Paginatio>n log{
ic	Strin
g}
 pageToken = posts.getNextPageToken();	if (pa
geToken == null || ++pageCount = 5) 		bre
ak;		System.out.println("-- Ne
}xt 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.