Guide de référence

Ce document fournit une documentation de référence détaillée pour 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 figurant dans les sections spécifiques au langage de programmation du guide du développeur.

Contenus

Audience

Ce document est destiné aux programmeurs qui souhaitent écrire des applications clientes capables d'interagir avec Blogger.

Il s'agit d'un document de référence. Nous partons du principe que vous comprenez les concepts présentés dans le guide du développeur et les idées générales sous-jacentes au protocole des API Google Data.

Types de flux Blogger

Blogger fournit deux représentations du contenu d'un 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 IUG, s'il fournit un flux complet ou un flux récapitulatif aux syndicats et aux agrégateurs.

Lorsque votre application cliente envoie une requête de flux non authentifiée, elle reçoit le type de flux spécifié par le propriétaire du blog.

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 de Blogger

L'API Blogger Data est compatible avec presque tous les paramètres de requête standards de l'API Google Data.

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 mis à jour entre le 16 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

Documentation de référence sur les é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 de publication Atom.

Le reste de cette section fournit des remarques spécifiques sur l'utilisation de certains éléments standards par Blogger.

Entrées brouillons

Un brouillon d'une 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:

<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 dates mises à jour

L'horodatage indiqué dans l'élément Atom standard <published> correspond à la "date de publication" qu'un utilisateur peut définir dans l'IUG de Blogger.

Lorsque le 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 conserve que 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 standard <updated> pour indiquer la dernière fois qu'une entrée a été modifiée. Votre client ne peut pas contrôler la valeur <updated>. Blogger définit toujours la dernière date de 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 plus d'informations sur l'interrogation de dates mises à jour, consultez la documentation de référence sur les paramètres de requête de Blogger.

Associer des commentaires à des posts

Le format d'exportation Blogger contient à la fois des articles et des entrées de commentaire dans un seul document de flux Atom. Pour 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 post ou à un commentaire.

De plus, l'association de l'entrée de commentaire à l'entrée de post à laquelle elle appartient se fait via l'extension Atom Threading. Dans l'exemple ci-dessous, l'élément <thr:in-reply-to> de l'entrée de commentaire pointera vers le post en utilisant l'identifiant d'entrée de post dans le paramètre ref. Il renvoie également à l'URL HTML du post 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 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>

Documentation de référence sur le schéma des flux Blogger

  1. Flux Liste des blogs
  2. Flux d'articles de blog
  3. Flux des commentaires du blog
  4. Flux de commentaires de l'article de blog

Haut de page