Publicaciones: lista

Recupera una lista de entradas. Pruébalo ahora y ve un ejemplo.

Si las entradas están en un blog privado, la autorización es obligatoria. Si las entradas son de un blog público, entonces se puede llamar a este método sin autorización.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro Valor Descripción
Parámetros obligatorios
blogId string El ID del blog del que se obtendrán las entradas.
Parámetros opcionales
endDate datetime Fecha de la última publicación que se debe recuperar, un date-time con formato RFC 3339
fetchBodies boolean Si se incluye el contenido del cuerpo de las publicaciones (predeterminado: verdadero) Esto se debe configurar como falso cuando no se requieran los cuerpos de los mensajes para ayudar a minimizar el tráfico. (Predeterminado: true)
fetchImages boolean Si se incluyen los metadatos de URL de imágenes de cada publicación
labels string Lista de etiquetas separadas por comas para buscar.
maxResults unsigned integer Cantidad máxima de publicaciones que se deben recuperar.
orderBy string Se aplicó el orden a los resultados.

Los valores aceptables son los siguientes:
  • "published": Ordena la fecha en la que se publicó la entrada.
  • "updated": Ordenado según la fecha de la última actualización de la publicación
sortOption string UNAVAILABLE NOW

Se aplicó la dirección de clasificación a los resultados.

Los valores aceptables son los siguientes:
  • "descending": Ordena las publicaciones de forma descendente según la hora (configuración predeterminada)
  • "ascending": Ordena las publicaciones de forma ascendente en el tiempo
pageToken string Token de continuación si se pagina la solicitud.
startDate datetime Fecha de la primera publicación que se debe recuperar, un date-time con formato RFC 3339
status string

Los valores aceptables son los siguientes:
  • "draft": Borradores de publicaciones
  • "live": entradas publicadas
  • "scheduled": entradas que están programadas para publicarse en el futuro.
view string

Los valores aceptables son los siguientes:
  • "ADMIN": Detalle de nivel de administrador
  • "AUTHOR": Detalle del nivel de autor
  • "READER": Detalle del nivel de lector

Cuerpo de la solicitud

No proporciones un cuerpo de 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 El tipo de esta entidad. Siempre blogger#postList.
nextPageToken string Token de paginación para recuperar la página siguiente, si existe.
items[] list La lista de entradas 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 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();
}

Pruébela.

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