Cette page a été traduite par l'API Cloud Translation.

Guide de référence

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 de langage de programmation. Pour en savoir plus sur les bibliothèques clientes, consultez les liens les sections spécifiques au langage de programmation du guide du développeur.

Sommaire

Audience
Types de flux Blogger
Référence des paramètres de requête Blogger
Référence des éléments Blogger

Audience

Ce document s'adresse aux programmeurs qui souhaitent écrire des applications clientes pouvant interagir avec Blogger.

C'est un document de référence. il suppose que vous comprenez les concepts présentées dans le guide du développeur ; et les idées générales qui sous-tendent les API Google Data protocole.

Types de flux Blogger

Blogger propose deux représentations du contenu d'un blog dans les flux: les flux complets et 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 agrégateurs et aux syndicateurs.

Lorsque votre application cliente envoie une demande 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, quel que soit ce que le propriétaire du blog a spécifié.

Référence des paramètres de requête Blogger

L'API Blogger Data est compatible avec la quasi-totalité des paramètres de requête standards de l'API Google Data.

Blogger ne prend pas en charge les fonctions q (recherche textuelle) et Paramètres 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 permet de récupérer l'intégralité du blog mises à 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 le module Atom spécification du format de syndication 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 de brouillon d'entrée :

<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 spécifiée. un brouillon.

Dates de publication et de mise à jour

Le code temporel indiqué dans l'élément <published> Atom standard correspond à la "date de publication" qu'un utilisateur peut définir dans l'interface graphique 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 sans spécifier de Valeur <published>, Blogger conserve la date de publication de l'entrée seul.

Toutefois, si votre client spécifie une valeur pour le paramètre <published> lorsque vous créez ou modifiez une entrée, puis 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 et l'heure de la dernière modification d'une entrée. Votre client ne peut pas contrôler Valeur <updated> ; Blogger définit toujours la date de dernière mise à jour de l'entrée à 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 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 les requêtes sur les dates mises à jour, consultez la documentation de référence sur les paramètres de requête Blogger.

Associer des commentaires à des posts

L'exportation Blogger format contient à la fois les articles et les entrées de commentaires 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 aura une Le paramètre term qui indique si l'entrée correspond à un post ou à une commentaire.

De plus, l'association de l'entrée de commentaire à l'entrée de post à laquelle elle appartient est effectuée à l'aide de l'extension de threading Atom. Dans l'exemple ci-dessous, l'élément <thr:in-reply-to> de l'entrée de commentaire pointe vers le post à l'aide de l'identifiant de l'entrée de post dans le paramètre ref. Il renvoie également vers l'URL HTML du message via la propriété 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>

Haut de page