Commenti: elenco

Recupera l'elenco dei commenti per un post. Prova subito o guarda un esempio.

Se i commenti si trovano su un blog privato, è necessaria l'autorizzazione. Se i commenti sono 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/postId/comments

Parametri

Nome del parametro Valore Descrizione
Parametri obbligatori
blogId string L'ID del blog da cui recuperare i commenti.
postId string L'ID del post da cui recuperare i commenti.
Parametri facoltativi
endDate datetime Ultima data di commento per il recupero, una data/ora con formattazione RFC 3339.
fetchBodies boolean Indica se il corpo del commento è incluso.
maxResults unsigned integer Numero massimo di commenti da includere nel risultato.
pageToken string Token di continuazione se la richiesta viene impaginata.
startDate datetime La prima data di commento per il recupero, una data/ora in formato RFC 3339.
status string

I valori accettati sono:
  • "emptied": commenti i cui contenuti sono stati rimossi
  • "live": commenti visibili pubblicamente
  • "pending": commenti in attesa di approvazione da parte dell'amministratore
  • "spam": commenti contrassegnati come spam dall'amministratore
view string

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

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#commentList",
  "nextPageToken": string,
  "prevPageToken": string,
  "items": [
    comments Resource
  ]
}
Nome proprietà Valore Descrizione Note
kind string Il tipo di questa voce. Sempre blogger#commentList.
nextPageToken string Token di impaginazione per recuperare la pagina successiva, se esistente.
prevPageToken string Token di impaginazione per recuperare la pagina precedente, se esistente.
items[] list L'elenco delle risorse relative ai commenti per il post specificato.

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 http://buzz.blogger.com/ blog.
String BUZZ_BLOG_ID = "2399953";

// The PostId for a buzz post with comments.
String BUZZ_POST_ID = "5310628572012276714";

// 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-CommentsList-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
List commentsListAction = blogger.comments().list(BUZZ_BLOG_ID, BUZZ_POST_ID);

// Restrict the result content to just the data we need.
commentsListAction.setFields("items(author/displayName,content),nextPageToken");

// This step sends the request to the server.
CommentList comments = commentsListAction.execute();

// Now we can navigate the response.
while(comments.getItems() != null && !comments.getItems().isEmpty()){
	for(Comment comment : comments.getItems()) {
		System.out.println(comment.getAuthor().getDisplayName()+": "+comment.getContent());
	}

	// Pagination logic
	String pageToken = comments.getNextPageToken();
	if(pageToken == null) {
		break;
	}
	System.out.println("-- Next page of comments");
	commentsListAction.setPageToken(pageToken);
	comments = commentsListAction.execute();
}

Prova.

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