Important: Il s'agit d'une ancienne version de cette page. Pour accéder à la dernière version, utilisez les liens situés dans la barre de navigation de gauche.
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 en savoir plus sur la bibliothèque cliente, consultez les liens figurant dans les 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 qui sous-tendent le protocole des API Google Data.
Types de flux Blogger
Blogger fournit deux représentations du contenu de blog 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 fournit un flux complet ou un flux récapitulatif aux syndicateurs 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, indépendamment de ce que le propriétaire du blog a spécifié.
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 standards de l'API Google Data.
Blogger n'accepte pas les paramètres q (recherche textuelle) et 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 du 16 au 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 d'éléments Blogger
L'API Blogger Data n'utilise que des éléments Atom standards. Pour en savoir plus, consultez la spécification du format de syndication Atom 1.0 et le protocole de publication Atom.
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'article 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 d'entrée brouillon:
<entry xmlns:app='http://purl.org/atom/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
Le code temporel 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 et qu'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 modifie pas 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 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 que votre client publie ou modifie une entrée.
Vous pouvez utiliser les paramètres de requête standards published-min, published-max, updated-min et updated-max de l'API Google Data pour demander des entrées en fonction de leurs valeurs <published> ou <updated>. Toutefois, pour obtenir des remarques concernant l'interrogation sur des dates mises à jour, consultez la documentation de référence sur les paramètres de requête Blogger.
Associer des commentaires à des posts
Le format d'exportation Blogger contient à la fois des articles et des entrées de commentaires dans un seul document de flux Atom.
Afin de différencier les 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 correspond à un article ou à un commentaire.
De plus, l'utilisation de l'extension de threads Atom permet de lier l'entrée de commentaire à l'entrée de post à laquelle elle appartient. Dans l'exemple ci-dessous, l'élément <thr:in-reply-to> de l'entrée de commentaire pointera vers la publication en utilisant l'identifiant d'entrée de post dans le paramètre ref. Il renvoie également vers 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/opensearchrss/1.0/"
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 commment</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>