Publicaciones: lista

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

Se requiere autorización si las publicaciones se encuentran en un blog privado. Si las publicaciones se encuentran en un blog público, 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 ID del blog del que se recuperarán las publicaciones.
Parámetros opcionales
endDate datetime Es la fecha de la publicación más reciente que se recuperará, un date-time con formato RFC 3339.
fetchBodies boolean Indica si se incluye el contenido del cuerpo de las publicaciones (el valor predeterminado es verdadero). Este parámetro debe establecerse en falso cuando no se requieren los cuerpos de las publicaciones, para ayudar a minimizar el tráfico. (Predeterminado: true)
fetchImages boolean Indica si se incluyen los metadatos de la URL de la imagen para cada publicación.
labels string Lista de etiquetas separadas por comas para buscar.
maxResults unsigned integer Cantidad máxima de publicaciones que se recuperarán.
orderBy string Es el orden de clasificación aplicado a los resultados.

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.
sortOption string UNAVAILABLE NOW

Dirección de ordenamiento aplicada a los resultados.

Los valores aceptables son los siguientes:
  • "descending": Ordena las publicaciones de forma descendente según la fecha (opción predeterminada).
  • "ascending": Ordena las publicaciones de forma ascendente según la fecha.
pageToken string Es el token de continuación si la solicitud se paginó.
startDate datetime Es la fecha de publicación más antigua que se puede recuperar, un date-time con formato RFC 3339.
status string

Los valores aceptables son los siguientes:
  • "draft": Publicaciones en borrador
  • "live": Publicaciones publicadas
  • "scheduled": Publicaciones programadas para publicarse en el futuro.
view string

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

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,
  &quo}t;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 un token de paginación para recuperar la página siguiente, si existe.
items[] list Es 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 = "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();

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.