Commentaires: liste

Récupère la liste des commentaires d'un article. Essayez dès maintenant ou consultez un exemple.

Une autorisation est requise si les commentaires concernent un blog privé. Si les commentaires se trouvent sur un blog public, cette méthode peut être appelée sans autorisation.

Requête

Requête HTTP

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

Paramètres

Nom du paramètre	Valeur	Description
Paramètres obligatoires
blogId	string	ID du blog à partir duquel extraire les commentaires.
postId	string	ID de l'article à partir duquel extraire les commentaires.
Paramètres facultatifs
endDate	datetime	Date la plus récente du commentaire à extraire, date et heure au format RFC 3339.
fetchBodies	boolean	Indique si le corps des commentaires est inclus.
maxResults	unsigned integer	Nombre maximal de commentaires à inclure dans le résultat.
pageToken	string	Jeton de continuité si la demande est paginée.
startDate	datetime	Première date du commentaire à récupérer, date et heure au format RFC 3339.
status	string	Les valeurs possibles sont les suivantes: "emptied" : commentaires dont le contenu a été supprimé "live" : commentaires visibles publiquement "pending" : commentaires en attente de l'approbation de l'administrateur "spam" : commentaires marqués comme spam par l'administrateur
view	string	Les valeurs possibles sont les suivantes: "ADMIN" : détails au niveau de l'administrateur "AUTHOR" : détails au niveau de l'auteur "READER" : détails au niveau de l'administrateur

Corps de la requête

Ne spécifiez pas de corps de requête pour cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "kind": "blogger#commentList",
  "nextPageToken": string,
  "prevPageToken": string,
  "items": [
    comments Resource
  ]
}

Nom de propriété	Valeur	Description	Remarques
kind	string	Type d'entrée. Toujours blogger#commentList.
nextPageToken	string	Jeton de pagination permettant d'extraire la page suivante, le cas échéant.
prevPageToken	string	Jeton de pagination permettant d'extraire la page précédente, le cas échéant.
items[]	list	Liste des ressources de commentaires pour l'article spécifié.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Elle utilise la bibliothèque cliente 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();
}

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.