Post: elenco

Recupera un elenco di post. Prova subito o guarda un esempio.

L'autorizzazione è obbligatoria se i post si trovano su un blog privato. Se i post si trovano su un blog pubblico, questo metodo può essere chiamato senza autorizzazione.

Richiesta

Richiesta HTTP

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

Parametri

Nome parametro Valore Descrizione
Parametri obbligatori
blogId string L'ID del blog da cui recuperare i post.
Parametri facoltativi
endDate datetime Data dell'ultimo post da recuperare, un date-time con formattazione RFC 3339.
fetchBodies boolean Indica se i contenuti del corpo dei post sono inclusi (impostazione predefinita: true). Questo valore deve essere impostato su false quando i corpi dei post non sono necessari, per ridurre al minimo il traffico. (Predefinito: true)
fetchImages boolean Se sono inclusi i metadati dell'URL dell'immagine per ogni post.
labels string Elenco separato da virgole di etichette da cercare.
maxResults unsigned integer Il numero massimo di post da recuperare.
orderBy string Ordine di ordinamento applicato ai risultati.

I valori accettati sono:
  • "published": ordina in base alla data di pubblicazione del post
  • "updated": ordina in base alla data dell'ultimo aggiornamento del post
sortOption string UNAVAILABLE NOW

Direzione di ordinamento applicata ai risultati.

I valori accettati sono:
  • "descending": ordina i post in ordine decrescente nel tempo (impostazione predefinita)
  • "ascending": ordina i post in ordine crescente nel tempo
pageToken string Token di continuazione se la richiesta è paginata.
startDate datetime La data del post meno recente da recuperare, un date-time con formattazione RFC 3339.
status string

I valori accettati sono:
  • "draft": Post in bozza
  • "live": Post pubblicati
  • "scheduled": post la cui pubblicazione è pianificata per il futuro.
view string

I valori accettati sono:
  • "ADMIN": dettagli a livello di amministratore
  • "AUTHOR": Dettagli a livello di autore
  • "READER": livello di dettaglio del lettore

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  &quo}t;items": [
    posts Resource
  ]
Nome proprietà Valore Descrizione Note
kind string Il tipo di questa entità. Sempre blogger#postList.
nextPageToken string Token di paginazione per recuperare la pagina successiva, se esistente.
items[] list L'elenco dei post di questo blog.

Esempi

Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).

Java

Utilizza la libreria client 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();

Prova

Utilizza Explorer API di seguito per chiamare questo metodo sui dati live e visualizzare la risposta.