Post: elenco

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

Se i post si trovano in un blog privato, è necessaria l'autorizzazione. Se i post si trovano su un blog pubblico, questo metodo può essere chiamato senza autorizzazione.

Risorse richieste:

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri obbligatori
blogId string L'ID del blog da cui recuperare i post.
Parametri facoltativi
endDate datetime Data del post più recente per il recupero, in formato date-time con la formattazione RFC 3339.
fetchBodies boolean Indica se il contenuto del corpo dei post è incluso (valore predefinito: true). Deve essere impostato su false quando i corpi dei post non sono obbligatori, in modo da ridurre al minimo il traffico. (Valore predefinito: true)
fetchImages boolean Indica se i metadati dell'URL immagine per ogni post sono inclusi.
labels string Elenco separato da virgole di etichette da cercare.
maxResults unsigned integer Numero massimo di post da recuperare.
orderBy string 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 in tempo (impostazione predefinita)
  • "ascending": ordina i post in ordine crescente in tempo
pageToken string Token di continuazione se la richiesta viene impaginata.
startDate datetime La prima data di caricamento per il recupero, un date-time con formattazione RFC 3339.
status string

I valori accettati sono:
  • "draft": bozze di post
  • "live": post pubblicati
  • "scheduled": post pianificati per la pubblicazione in futuro.
view string

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

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

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

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Nome proprietà Valore Descrizione Note
kind string Il tipo di questa entità. Sempre blogger#postList.
nextPageToken string Token di impaginazione 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 di 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();
}

Prova.

Utilizza l'Explorer API di seguito per richiamare questo metodo sui dati in tempo reale e visualizzare la risposta.