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:
|
sortOption |
string |
UNAVAILABLE NOW
Dirección de ordenamiento aplicada a los resultados. Los valores aceptables son los siguientes:
|
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:
|
view |
string |
Los valores aceptables son los siguientes:
|
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.