Important : La version 2.0 de l'API Google Data ne sera plus prise en charge à partir du 30 septembre 2024. Pour assurer un fonctionnement continu, mettez à jour vos applications qui dépendent de la version 2.0 de l'API Google Data vers la dernière version de l'API. Pour accéder à la version la plus récente, utilisez les liens de la barre de navigation de gauche. Remarque: Bien que certaines requêtes GET (telles que les posts de fiches) continuent d'être acceptées en tant qu'URL de flux, il existe de légères différences au niveau de leur comportement. Pour en savoir plus, consultez la documentation de l'aide Blogger.
Ce document fournit une documentation de référence détaillée sur le protocole brut (XML et HTTP) de l'API Blogger Data.
Ce document ne contient pas d'informations sur les bibliothèques clientes du langage de programmation. Pour obtenir des informations de référence sur les bibliothèques clientes, consultez les liens des sections spécifiques au langage de programmation du guide du développeur.
Sommaire
Audience
Ce document est destiné aux programmeurs qui souhaitent écrire des applications clientes pouvant interagir avec Blogger.
Il s'agit d'un document de référence qui part du principe que vous comprenez les concepts présentés dans le guide du développeur, ainsi que les idées générales sur le protocole des API Google Data.
Types de flux Blogger
Blogger propose deux représentations du contenu des blogs dans les flux: les flux complets et les flux récapitulatifs. Un flux complet contient des articles de blog complets, tandis qu'un flux récapitulatif ne contient qu'un court extrait de chaque article.
Le propriétaire d'un blog peut spécifier, à l'aide des paramètres de l'IUG, si le blog doit fournir un flux complet ou récapitulatif aux syndicaux et aux agrégateurs.
Lorsque votre application cliente envoie une requête non authentifiée pour un flux, elle reçoit le type de flux spécifié par le propriétaire du blog.
Toutefois, lorsque votre application cliente envoie une requête authentifiée, elle reçoit toujours un flux complet, quelles que soient les spécifications du propriétaire du blog.
Documentation de référence sur les paramètres de requête Blogger
L'API Blogger Data est compatible avec presque tous les paramètres de requête de l'API Google Data standards.
Blogger ne prend pas en charge le paramètre author.
Les paramètres de requête updated-min et updated-max sont ignorés, sauf si le paramètre orderby est défini sur updated. Par exemple, l'URL suivante récupère tous les articles de blog qui ont été mis à jour entre le 16 mars 2008 et le 24 mars 2008:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Référence des éléments Blogger
L'API Blogger Data n'utilise que des éléments Atom standards. Pour en savoir plus, consultez les spécifications du format de syndication Atom 1.0 et le protocole Atom Publishing.
Le reste de cette section fournit quelques remarques spécifiques sur l'utilisation de certains éléments standards par Blogger.
Brouillons d'entrées
Un brouillon d'entrée de blog est marqué à l'aide de l'élément d'extension <app:draft> défini dans le document Atom Publishing Protocol. Voici un exemple de brouillon d'entrée:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Si aucun élément <draft> n'est spécifié, l'entrée n'est pas un brouillon.
Dates de publication et de mise à jour
L'horodatage indiqué dans l'élément Atom <published> standard correspond à la "date de publication" qu'un utilisateur peut définir dans l'IUG de Blogger.
Lorsque votre client crée une entrée, s'il ne spécifie pas de valeur pour <published>, Blogger définit la date de publication de l'entrée sur l'heure actuelle du serveur. Lorsque votre client modifie une entrée, mais ne spécifie pas de valeur <published>, Blogger ne tient pas compte de la date de publication de l'entrée.
Toutefois, si votre client spécifie une valeur pour l'élément <published> lors de la création ou de la modification d'une entrée, Blogger définit la date de publication de l'entrée sur la valeur spécifiée. Cela peut être utile pour des tâches telles que l'importation d'anciennes entrées à partir d'un autre système de blog (tout en conservant les dates de création d'origine).
Blogger utilise l'élément Atom <updated> standard pour indiquer la date de la dernière modification d'une entrée. Votre client ne peut pas contrôler la valeur <updated>. Blogger définit toujours la date de dernière mise à jour de l'entrée sur l'heure actuelle du serveur chaque fois qu'il publie ou modifie une entrée.
Vous pouvez utiliser les paramètres de requête standards de l'API Google Data published-min, published-max, updated-min et updated-max pour demander des entrées en fonction de leurs valeurs <published> ou <updated>. Toutefois, pour en savoir plus sur l'interrogation des dates mises à jour, consultez la documentation de référence sur les paramètres de requête Blogger.
Associer les commentaires aux posts
Le format d'exportation Blogger contient à la fois des articles et des commentaires dans un même document de flux Atom.
Pour différencier ces deux types d'entrées, Blogger utilise l'élément <atom:category>. Cet élément comporte un paramètre term qui indique si l'entrée est destinée à un article ou à un commentaire.
De plus, l'utilisation de l'extension Atom Threading permet de lier l'entrée de commentaire à l'entrée du post auquel elle appartient. Dans l'exemple ci-dessous, l'élément <thr:in-reply-to> de l'entrée du commentaire pointera vers l'article en utilisant l'identifiant d'entrée du post dans le paramètre ref. Il renvoie également à l'URL HTML de l'article via le paramètre href.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
xmlns:thr="http://purl.org/syndication/thread/1.0">
...
<-- A blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID</id>
<content type="html">This is my first post</content>
<link rel="alternate" type="text/html"
href="http://blogName.blogspot.com/2007/04/first-post.html">
</link>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#post"/>
...
</entry>
<-- A comment to the blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
<content type="html">This is my first comment</content>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#comment"/>
<thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html"
ref="tag:blogger.com,1999:blog-blogID.post-postID"
type="text/html"/>
...
</entry>
</feed>
Référence du schéma de flux Blogger
- Flux de liste des blogs
- Flux d'articles de blog
- Flux de commentaires du blog
- Flux de commentaires dans les articles de blog