Récupère une liste de posts. Essayer maintenant ou voir un exemple
Une autorisation est requise si les articles se trouvent sur un blog privé. Si les messages sont publiés sur un blog public, cette méthode peut être appelée sans autorisation.
Demande
Requête HTTP :
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts
Paramètres
Nom du paramètre | Value | Description |
---|---|---|
Réglages obligatoires | ||
blogId |
string |
Identifiant du blog à partir duquel les articles sont récupérés. |
Paramètres facultatifs | ||
endDate |
datetime |
Date de publication la plus récente à récupérer : date-time au format RFC 3339.
|
fetchBodies |
boolean |
Indique si le corps du message est inclus (par défaut: vrai). Ce paramètre doit être défini sur "false" lorsque les corps de message ne sont pas requis pour réduire le trafic.
(Par défaut : true )
|
fetchImages |
boolean |
Indique si les métadonnées d'URL d'image sont incluses pour chaque article. |
labels |
string |
Liste de libellés séparés par une virgule à rechercher. |
maxResults |
unsigned integer |
Nombre maximal d'articles à récupérer. |
orderBy |
string |
Ordre de tri appliqué aux résultats.
Les valeurs autorisées sont les suivantes :
|
sortOption |
string |
UNAVAILABLE NOW
Direction du tri appliquée aux résultats. Les valeurs autorisées sont les suivantes :
|
pageToken |
string |
Jeton de continuité si la page est paginée. |
startDate |
datetime |
Première date de publication à récupérer (date-time au format RFC 3339).
|
status |
string |
Les valeurs autorisées sont les suivantes :
|
view |
string |
Les valeurs autorisées sont les suivantes :
|
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é | Value | Description | Remarques |
---|---|---|---|
kind |
string |
Genre de cette entité. Toujours blogger#postList . |
|
nextPageToken |
string |
Jeton de pagination permettant de récupérer 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
Il 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.