Posts: liste

Récupère une liste de posts. Essayer maintenant ou voir un exemple

Une autorisation est requise si les posts se trouvent sur un blog privé. Si les posts 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 posts.
Paramètres facultatifs
endDate datetime Date du dernier post à récupérer, date-time au format RFC 3339.
fetchBodies boolean Indique si le corps du contenu des posts est inclus (valeur par défaut : true). Cette valeur doit être définie sur "false" lorsque les corps de post ne sont 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 post sont incluses.
labels string Liste de libellés à rechercher, séparés par une virgule.
maxResults unsigned integer Nombre maximal de posts à récupérer.
orderBy string Ordre de tri appliqué aux résultats.

Les valeurs acceptées sont les suivantes :
  • "published" : trier par date de publication du post
  • "updated" : trier par date de dernière mise à jour du post
sortOption string UNAVAILABLE NOW

Sens de tri appliqué aux résultats.

Les valeurs acceptées sont les suivantes :
  • "descending" : trier les posts par ordre chronologique décroissant (par défaut)
  • "ascending" : trier les posts par ordre chronologique croissant
pageToken string Jeton de continuation si la requête est paginée.
startDate datetime Date de publication la plus ancienne à récupérer, au format RFC 3339.date-time
status string

Les valeurs acceptées sont les suivantes :
  • "draft" : brouillons de posts
  • "live" : posts publiés
  • "scheduled" : posts dont la publication est programmée.
view string

Les valeurs acceptées sont les suivantes :
  • "ADMIN" : informations au niveau de l'administrateur
  • "AUTHOR" : informations au niveau de l'auteur
  • "READER" : niveau de détail 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 Type 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 posts 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

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.