Posts: liste

Récupère une liste de posts. Essayez dès maintenant ou consultez un exemple.

Une autorisation est requise si les articles sont publiés sur un blog privé. Si les articles 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

Paramètres

Nom du paramètre	Valeur	Description
Paramètres obligatoires
blogId	string	ID du blog à partir duquel récupérer les articles.
Paramètres facultatifs
endDate	datetime	Date de la dernière publication à récupérer, date-time au format RFC 3339.
fetchBodies	boolean	Indique si le corps des articles est inclus (par défaut: vrai). Définissez ce paramètre sur "false" lorsque le corps des messages n'est pas requis, afin de réduire le trafic. (Par défaut : true)
fetchImages	boolean	Indique si les métadonnées de l'URL de l'image de chaque article sont incluses.
labels	string	Liste de libellés à rechercher, séparés par une virgule.
maxResults	unsigned integer	Nombre maximal de posts à extraire.
orderBy	string	Ordre de tri appliqué aux résultats. Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "published" : trie en fonction de la date de publication de l'article "updated" : trie en fonction de la date de dernière mise à jour du post
sortOption	string	UNAVAILABLE NOW Sens de tri appliqué aux résultats. Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "descending" : trie les posts par ordre décroissant (par défaut) "ascending" : trie les posts par ordre croissant dans le temps.
pageToken	string	Jeton de continuité si la demande est paginée.
startDate	datetime	Date de publication la plus proche à récupérer, date-time au format RFC 3339.
status	string	Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "draft" : brouillons de posts "live" : articles publiés "scheduled" : posts dont la publication est prévue à une date ultérieure.
view	string	Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder"> </ph> "ADMIN" : détails au niveau de l'administrateur "AUTHOR" : détails au niveau de l'auteur "READER" : détails au niveau du lecteur

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#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}

Nom de propriété	Valeur	Description	Remarques
kind	string	Genre de cette entité. Toujours blogger#postList.
nextPageToken	string	Jeton de pagination permettant d'extraire la page suivante, le cas échéant.
items[]	list	Liste des articles de ce blog.

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 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();
}

Essayer

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