Publicaciones: búsqueda

Busca una publicación que coincida con los términos de búsqueda proporcionados. Pruébalo ahora y ve un ejemplo.

Se requerirá autorización si el blog en el que se realiza la búsqueda es privado.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro Valor Descripción
Parámetros obligatorios
blogId string ID del blog en el que se realizará la búsqueda.
q string Son los términos de búsqueda que se usarán en la búsqueda.
Parámetros opcionales
fetchBodies boolean Indica si se incluye el contenido del cuerpo de las publicaciones. Para minimizar el tráfico, establece este parámetro en falso cuando no se requiera el contenido del cuerpo de la publicación. (predeterminado: true)
orderBy string Es el orden de clasificación que se aplica a los resultados de la búsqueda.

Los valores aceptables son los siguientes:
  • “published”: Ordena por la fecha en que se publicó la entrada.
  • "updated": Ordena por la fecha en la que se actualizó la publicación por última vez.

Cuerpo de la solicitud

No proporciones un cuerpo de la solicitud con este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Nombre de la propiedad Valor Descripción Notas
kind string Es el tipo de esta entidad. Siempre blogger#postList
nextPageToken string Es el token de paginación para recuperar la página siguiente, si existe.
items[] list Es la lista de publicaciones de este blog.

Ejemplos

Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas cliente para consultar una lista de lenguajes admitidos).

Java

Usa la 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());
	}
}

Pruébalo

Usa el Explorador de APIs que se encuentra a continuación para llamar a este método en datos en vivo y ver la respuesta.