Ce document explique comment utiliser l'API JSON de Blogger.
Contenus
Introduction
Ce document est destiné aux développeurs qui souhaitent créer des applications capables d'interagir avec l'API JSON de Blogger.
L'API JSON de Blogger est une extension de la version 2.0 de l'API Blogger Data. Si vous souhaitez récupérer des données dans Blogger au format JSON plutôt qu'au format XML, utilisez l'API JSON de Blogger. Si vous souhaitez récupérer des données au format XML, utilisez l'API Blogger Data.
Cette version de l'API JSON Blogger est actuellement en lecture seule. Toutefois, nous prévoyons d'ajouter d'autres fonctionnalités de lecture/écriture. N'hésitez pas à demander d'autres fonctionnalités sur le Forum d'aide Blogger.
Avant de commencer
Obtenir un compte Google
Assurez-vous de disposer d'un compte Google. Nous vous recommandons d'utiliser un compte Google distinct à des fins de développement et de test pour vous protéger contre toute perte accidentelle de données. Si vous disposez déjà d'un compte de test, vous êtes prêt. Vous pouvez visiter l'interface utilisateur de Blogger pour configurer, modifier ou afficher vos données de test.
Familiarisez-vous avec Blogger
Si vous ne connaissez pas les concepts de Blogger, lisez ce document et testez l'interface utilisateur avant de commencer à coder. Dans ce document, nous partons du principe que vous connaissez bien Blogger, les concepts de programmation Web et les formats de données Web.
En savoir plus sur l'autorisation des requêtes et l'identification de votre application
Lorsque votre application demande des données privées, elle doit être autorisée par un utilisateur authentifié qui a accès à ces données.
Lorsque votre application demande des données publiques, la requête n'a pas besoin d'être autorisée, mais elle doit être accompagnée d'un identifiant, tel qu'une clé API.
Pour savoir comment autoriser des requêtes et utiliser des clés API, consultez la page Autoriser des requêtes et identifier votre application dans le document "Utiliser l'API".
Arrière-plan de l'API JSON Blogger
Concepts de Blogger
Blogger repose sur cinq concepts de base:
- Blogs: concept racine de l'API. Un blog contient des articles et des pages. Il s'agit du conteneur des méta-informations du blog, comme le nom et la description.
- Articles : un article de blog est l'élément publiable créé par l'auteur du blog. Cette information est destinée à refléter la périodicité actuelle des auteurs au monde. Il est évident qu'avec le temps, le contenu des articles de blog vieillit et devient moins important.
- Commentaires: un commentaire est un lieu où les personnes (autres que l'auteur de l'article de blog) réagissent à ce que l'auteur a écrit. Des briques aux bouquets,
- Pages : une page est un emplacement pour un contenu statique tel que des informations biographiques ou des moyens de contacter l'utilisateur. Ces informations sont généralement intemporelles et ne changent pas très souvent.
- Utilisateurs : un utilisateur est une personne qui interagit avec Blogger en tant qu'auteur, administrateur ou lecteur. Pour les blogs publics, les lecteurs peuvent être anonymes, mais sur les blogs privés, un lecteur doit être identifié par Blogger.
Modèle de données de l'API JSON pour Blogger
Une ressource est une entité de données individuelle dotée d'un identifiant unique. L'API JSON de Blogger fonctionne sur cinq types de ressources:
- Ressource Blogs : représente un blog.
- Ressource Posts: représente une publication. Chaque ressource Posts est une enfant d'une ressource Blogs.
- Ressource des commentaires: représente un commentaire sur un post spécifique. Chaque ressource"Comments"est un enfant d'une ressource"Posts".
- Ressource Pages : représente une page statique. Chaque ressource Pages est un enfant d'une ressource Blogs.
- Ressource pour les utilisateurs : représente un utilisateur non anonyme. Ce champ permet d'identifier l'auteur d'une page, d'un post ou d'un commentaire.
Le modèle de données de l'API JSON Blogger repose sur des groupes de ressources, appelés collections:
- Collection de blogs
- Une collection <span=\"quot;apicollection&&tt;Blogs comprend tous les blogs auxquels un utilisateur a accès. Vous pouvez répertorier les blogs par utilisateur ou récupérer un seul blog par ID.</span=\"quot;apicollection">
- Collecte des posts
- Une collection d'articles contient toutes les ressources des articles d'une ressource Blogs spécifique.
- Collecte des commentaires
- Une collection de commentaires comprend toutes les ressources des commentaires d'une ressource Postsspécifique.
- Collection de pages
- Une collection de pages contient toutes les ressources de pages d'une ressource Blogs spécifique.
- Collection d'utilisateurs
- Une collection d'utilisateurs est constituée de toutes les ressources utilisateur sur Blogger et ne peut donc pas être répertoriée. Un utilisateur peut récupérer ses propres ressources utilisateur (mais personne d'autre) à l'aide de son ID ou de l'identifiant
self
.
Opérations de l'API JSON Blogger
Vous pouvez appeler deux méthodes différentes sur des collections et des ressources dans l'API JSON Blogger, comme décrit dans le tableau suivant.
Operations | Description | Mappages HTTP REST |
---|---|---|
list | Répertorie toutes les ressources d'une collection. | GET sur un URI de collection. |
obtenir | Récupère une ressource spécifique. | GET sur un URI de ressource. |
Le tableau ci-dessous indique les méthodes compatibles avec chaque type de ressource. Toutes les opérations list et get sur les blogs privés nécessitent une authentification.
Type de ressource |
Méthodes compatibles |
|
---|---|---|
liste | get | |
Blogs | oui | oui |
Posts | oui | oui |
Commentaires | oui | oui |
Pages | oui | oui |
Utilisateurs | non | oui |
Styles d'appel
Il existe plusieurs façons d'appeler l'API:
- Utiliser REST directement ou à partir de JavaScript (aucun code côté serveur n'est nécessaire)
- Utiliser les bibliothèques clientes
REST
Il s'agit d'un style d'architecture logicielle qui permet de demander et modifier des données de manière pratique et cohérente.
Le terme REST est l'acronyme de Representational State Transfer. Dans le contexte des API Google, il désigne l'utilisation de verbes HTTP pour extraire et modifier des représentations de données stockées par Google.
Dans un système RESTful, les ressources sont stockées dans un datastore. Un client envoie une requête pour que le serveur exécute une action spécifique (par exemple la création, l'extraction, la mise à jour ou la suppression d'une ressource), et le serveur exécute l'action et envoie une réponse, souvent sous la forme d'une représentation de la ressource spécifiée.
Dans les API RESTful de Google, le client spécifie une action à l'aide d'un verbe HTTP comme POST
, GET
, PUT
ou DELETE
. Il spécifie une ressource par un URI unique au format suivant:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Étant donné que toutes les ressources d'API possèdent des URI uniques accessibles via HTTP, REST permet la mise en cache des données, et son fonctionnement est optimisé pour l'infrastructure distribuée du Web.
Les définitions de méthode figurant dans la documentation du standard HTTP 1.1 peuvent s'avérer utiles, car elles incluent les spécifications pour GET
, POST
, PUT
, et DELETE
.
REST dans l'API JSON de Blogger
Les opérations Blogger compatibles sont mappées directement à des verbes HTTP REST, comme décrit dans la section Opérations de l'API JSON Blogger.
Le format spécifique pour les URI de l'API JSON Blogger est le suivant:
https://www.googleapis.com/blogger/v2/users/userId https://www.googleapis.com/blogger/v2/users/self https://www.googleapis.com/blogger/v2/users/userId/blogs https://www.googleapis.com/blogger/v2/users/self/blogs https://www.googleapis.com/blogger/v2/blogs/blogId/posts https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments/commentId https://www.googleapis.com/blogger/v2/blogs/blogId/pages https://www.googleapis.com/blogger/v2/blogs/blogId/pages/pageId
Vous trouverez une explication complète des URI utilisés et des résultats de chaque opération disponible dans l'API dans la documentation de référence de l'API JSON pour Blogger.
Voici quelques exemples d'utilisation de ce format dans l'API JSON de Blogger.
Répertoriez les blogs auxquels l'utilisateur authentifié a accès:
GET https://www.googleapis.com/blogger/v2/users/self/blogs?key=YOUR-API-KEY
Téléchargez les articles sur le blog code.blogger.com (qui porte l'ID de blog 3213900):
GET https://www.googleapis.com/blogger/v2/blogs/3213900?key=YOUR-API-KEY
REST à partir de JavaScript
Vous pouvez appeler l'API JSON de Blogger à l'aide de REST à partir de JavaScript, à l'aide du paramètre de requête callback
et d'une fonction de rappel. Cela vous permet de développer des applications riches qui affichent des données Blogger sans écrire de code côté serveur.
L'exemple suivant récupère un article du blog code.blogger.com (après avoir remplacé YOUR-API-KEY par votre clé API).
<html> <head> <title>Blogger JSON API Example</title> </head> <body> <div id="content"></div> <script> function handleResponse(response) { document.getElementById("content").innerHTML += "<h1>" + response.title + "</h1>" + response.content; } </script> <script src="https://www.googleapis.com/blogger/v2/blogs/3213900/posts/8398240586497962757?callback=handleResponse&key=YOUR-API-KEY"></script> </body> </html>
Format des données
JSON
JSON (JavaScript Object Notation) est un format de données qui ne dépend pas d'un langage et qui fournit une représentation textuelle simple de structures de données arbitraires. Pour en savoir plus, accédez à json.org.