Pages: liste

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

Une autorisation est requise si les pages appartiennent à un blog privé. Si les pages figurent 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/pages

Paramètres

Nom du paramètre Valeur Description
Paramètres obligatoires
blogId string ID du blog à partir duquel extraire les pages.
Paramètres facultatifs
fetchBodies boolean Permet de déterminer si le corps de la page doit être récupéré.
status string

Les valeurs possibles sont les suivantes:
  • "draft" : pages brouillons (non publiées)
  • "imported" : pages dont le contenu a été supprimé
  • "live" : pages visibles publiquement
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#pageList",
  "items": [
    pages Resource
  ]
}
Nom de propriété Valeur Description Remarques
kind string Genre de cette entité. Toujours blogger#pageList
items[] list Liste des ressources de pages pour le blog 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";
// 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-PagesList-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
List pagesListAction = blogger.pages().list(BUZZ_BLOG_ID);
// Restrict the result content to just the data we need.
pagesListAction.setFields("items(content,title,updated,url)");
// This step sends the request to the server.
PageList pages = pagesListAction.execute();
// Now we can navigate the response.
if (pages.getItems() != null && !pages.getItems().isEmpty()) {
for (Page page : pages.getItems()) {
System.out.println("Title: " + page.getTitle());
System.out.println("URL: " + page.getUrl());
System.out.println("Last Updated:" + page.getUpdated());
System.out.println("Content: " + page.getContent());
}
}

Essayer

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