Blogs: listByUser

Autorisation requise

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

Requête

Requête HTTP

GET https://www.googleapis.com/blogger/v3/users/userId/blogs

Paramètres

Nom du paramètre Valeur Description
Paramètres obligatoires
userId string Identifiant de l'utilisateur dont les blogs doivent être récupérés. soit le mot self, soit l'ID de profil de l'utilisateur.
Paramètres facultatifs
fetchUserInfo boolean Indique si la réponse est une liste de blogs avec des informations spécifiques à l'utilisateur, et pas seulement des blogs.
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

Autorisation

Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation

Champ d'application
https://www.googleapis.com/auth/blogger
https://www.googleapis.com/auth/blogger.readonly

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#blogList",
  "items": [
    blogs Resource
  ],
  "blogUserInfos": [
    blogUserInfos Resource
  ]
}
Nom de propriété Valeur Description Remarques
kind string Genre de cette entité. Toujours blogger#blogList.
items[] list Liste des blogs pour lesquels cet utilisateur dispose de droits d'auteur ou d'administration.
blogUserInfos[] list Liste de niveau administrateur des informations de blog par utilisateur

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.

// 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-BlogListByUser-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action object.
ListByUser blogListByUserAction = blogger.blogs().listByUser("self");

// Restrict the result content to just the data we need.
blogListByUserAction.setFields("items(description,name,posts/totalItems,updated)");

// This step sends the request to the server.
BlogList blogList = blogListByUserAction.execute();

// Now we can navigate the response.
if (blogList.getItems() != null && !blogList.getItems().isEmpty()) {
	int blogCount = 0;
	for (Blog blog : blogList.getItems()) {
		System.out.println("Blog #" + ++blogCount);
		System.out.println("\tName: " + blog.getName());
		System.out.println("\tDescription: " + blog.getDescription());
		System.out.println("\tPost Count: " + blog.getPosts().getTotalItems());
		System.out.println("\tLast Updated: " + blog.getUpdated());
	}
}

Essayer

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