Postagens: pesquisa

Pesquisa uma postagem que corresponda aos termos da consulta especificada. Faça um teste agora ou veja um exemplo.

Será necessária a autorização se o blog que está sendo pesquisado for particular.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros obrigatórios
blogId string O ID do blog a ser pesquisado.
q string Termos de consulta a serem pesquisados.
Parâmetros opcionais
fetchBodies boolean Se o conteúdo do corpo das postagens está incluído. Para minimizar o tráfego, defina esse parâmetro como falso quando o conteúdo do corpo da postagem não for obrigatório. Padrão: true.
orderBy string A ordem de classificação aplicada aos resultados da pesquisa.

Os valores aceitáveis são:
  • "published": ordenar pela data em que a postagem foi publicada
  • "updated": classificar pela data da última atualização da postagem

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 http://buzz.blogger.com/ 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-PostsSearch-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
Search postsSearchAction = blogger.posts().search(BUZZ_BLOG_ID);
postsSearchAction.setQ("threaded comments");

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

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

// Now we can navigate the response.
if (posts.getItems() != null && !posts.getItems().isEmpty()) {
	for (Post post : posts.getItems()) {
		System.out.println("Title: " + post.getTitle());
		System.out.println("Published: " + post.getPublished());
		System.out.println("URL: " + post.getUrl());
		System.out.println("Content: " + post.getContent());
	}
}

Confira!

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