Flux - Protocole des données Blogger

Blogger - Blog Feeds / Flux - Protocole des données Blogger

Les flux sont très utiles pour les blogs. Ils servent à tenir informés les lecteurs, mais aussi à la fabrication de divers modules personnalisés.
Sur cette fiche, vous trouverez des informations sur les différents flux Blogger et les données qu'ils renferment.

Les types de flux

Blogger met à la disposition des administrateurs de blogs, 3 types de flux.

Type URI Description

Flux du blog

https://BLOG_NAME.blogspot.com/feeds/...

Flux destinés à la syndication du blog sur le web. Peuvent être également utilisés pour le développement.

API blogger.com

https://www.blogger.com/feeds/...

Flux réservés aux administrateurs de blogs, destinés à un usage public ou privé. Sont utilisés pour le développement.

API Google (Blogger V3)

https://www.googleapis.com/blogger/v3/...

Flux réservés aux administrateurs de blogs disposant d'une clef fournie par Blogger Developers... Ce type de flux n'est pas détaillé sur cette page. Référez-vous à la documentation de Google...



Liste des URL des flux d'extraction

Flux du blog

Contenu URI
Articles - LIST
https://BLOG_NAME.blogspot.com/feeds/posts/default
Pages - LIST
https://BLOG_NAME.blogspot.com/feeds/pages/default
Commentaires Blog - LIST
https://BLOG_NAME.blogspot.com/feeds/comments/default
Commentaires Article - LIST
https://BLOG_NAME.blogspot.com/feeds/POST_ID/comments/default

Flux blogger.com

Contenu URI
Blogs - LIST
https://www.blogger.com/feeds/PROFILE_ID/blogs
Articles - LIST
https://www.blogger.com/feeds/BLOG_ID/posts/default
Articles - GET
https://www.blogger.com/feeds/BLOG_ID/posts/default/POST_ID
Pages - LIST
https://www.blogger.com/feeds/BLOG_ID/pages/default
Pages - GET
https://www.blogger.com/feeds/BLOG_ID/pages/default/POST_ID
Commentaires Blog - LIST
https://www.blogger.com/feeds/BLOG_ID/comments/default
Commentaires Article - LIST
https://www.blogger.com/feeds/BLOG_ID/POST_ID/comments/default
Commentaires - GET
https://www.blogger.com/feeds/BLOG_ID/POST_ID/comments/default/COMMENT_ID
Archive du blog
https://www.blogger.com/feeds/BLOG_ID/archive/full 


Réglage du résumé du contenu

Le résumé du contenu (seulement articles et commentaires) peut être réglé de 2 manières :

Méthode 1 : Via le tableau de bord du blog

  • UI
  • Paramètres
  • Flux de site
  • Autoriser les flux de blog

Sélectionnez l'une des options disponibles :

  • Complet
  • Jusqu'au marqueur d'expansion (uniquement article)
  • Partiel
  • Aucun

Méthode 2 : En modifiant le répertoire /default dans l'url du flux

Répertoire Description Exemple
/default

Applique le réglage paramétré depuis l'interface (La méthode 1).

https://BLOG_NAME.blogspot.com/feeds/posts/default
/summary

Résumé - Contient uniquement les 200 premiers caractères de l'article.

https://BLOG_NAME.blogspot.com/feeds/posts/summary
/full

Complet - Contient l'intégralité de l'article.

https://BLOG_NAME.blogspot.com/feeds/posts/full

Note :

Les flux des pages autonomes ne sont pas paramétrables. Le contenu est disponible intégralement.



Paramètres additionnels des url des flux

Les paramètres ci-dessous permettent de personnaliser le contenu d'un flux. Ils s'ajoutent à la suite d'une url :

Exemple
https://BLOG_NAME.blogspot.com/feeds/posts/default?max-results=36&orderby=updated

Paramètres Description
callback

Appel de la fonction javascript.

alt

Type de représentation

atom (par defaut) ou rss.

Autres types : json, json-in-script, atom-in-script, rss-in-script, atom-service.

max-results

Nombre maximum d'entrées

Par défaut : 25

Maximum : 200

orderby

Ordre des entrées

lastmodified (par defaut), starttime ou updated.

published-min published-max

Horodatage - Date de publication

Filtre les entrées à partir des dates de publication.

Format : 2012-10-24T23:59:59

updated-min updated-max

Horodatage - Date de mise à jour

Filtre les entrées à partir des dates des mises à jour.

Format : 2012-10-24T23:59:59

Remarque :

Le paramètre est ignoré si la valeur de ordeby est updated.

start-index

Indice

Débute la sélection à partir de la Nième entrée.

Valeur par défaut : 1 (la première entrée)

category

Nom des libellés

Un ou plusieurs libellés peuvent être ajoutés.

Si plusieurs libellés sont ajoutés, ils doivent être séparés par une virgule (,) ou par : %7C.

La sélection reprendra uniquement les entrées communes à tous les libellés mentionnés.

Ce paramètre est disponible uniquement avec les flux de liste des articles si le paramètre q n'est pas mentionné.

q

Requête de recherche

Une ou plusieurs requêtes peuvent être ajoutées.

Ce paramètre est disponible uniquement avec les flux de liste des articles si le paramètre category n'est pas mentionné.

Note :

Attention aux caractères spéciaux qui sont susceptibles d'être introduit dans la requête : +, &, ", ', etc...

redirect

Redirection

Empêche une éventuelle redirection, par exemple vers Feedburners.

Valeur : false ou true



Disponibilité des paramètres additionnels

Paramètres Blogs - LIST Posts - LIST Posts - GET Pages - LIST Pages - GET Comments Blog - LIST Comments Post - LIST Comments - GET
category q Non Oui Non Non Non Non Non Non
max-results Oui Oui Non Oui Non Oui Oui Non
orderby Oui Oui Non Oui Non Oui Oui Non
published-min published-max updated-min updated-max Oui Oui Non Oui Non Oui Oui Non
start-index Oui Oui Non Oui Non Oui Oui Non
callback redirect alt Oui Oui Oui Oui Oui Oui Oui Oui


Représentations JSON des données

Liste des blogs


  version: value,
  encoding: value,
  feed: 
    xmlns: value,
    xmlns$openSearch: value,
    xmlns$gd: value,
    id:  $t: value ,
    updated:  $t: value ,
    title: 
      type: value,
      $t: value
    ,
    link: 
      rel: value,
      type: value,
      href: value
    ,
    author: 
      name:  $t: value ,
      uri:  $t: value ,
      email:  $t: value ,
      gd$image: 
        rel: value,
        width: value,
        height: value,
        src: value
      
    ,
    generator: 
      version: value,
      uri: value,
      $t: value
    ,
    openSearch$totalResults:  $t: value ,
    openSearch$startIndex:  $t: value ,
    openSearch$itemsPerPage:  $t: value ,
    entry: 
      id:  $t: value ,
      published:  $t: value ,
      updated:  $t: value ,
      category: 
        scheme: value,
        term: value
      ,
      title: 
        type: value,
        $t: value
      ,
      summary :  $t: value ,
      link: 
        rel: value,
        type: value,
        href: value,
      ,
      author: 
        name: value,
        uri: value,
        email: value,
        gd$image: 
          rel: value,
          width: value,
          height: value,
          src: value
        
      ,
      gd$extendedProperty: 
        name: value,
        value: value
      
    
  

Liste des articles


  version: value,
  encoding: value,
  feed: 
    xmlns: value,
    xmlns$openSearch: value,
    xmlns$blogger: value,
    xmlns$georss: value,
    xmlns$gd: value,
    xmlns$thr: value,
    id:  $t: value ,
    updated:  $t: value ,
    category:  term: value ,
    title: 
      type: value,
      $t: value
    ,
    subtitle: 
      type: value,
      $t: value
    ,
    link: 
      rel: value,
      type: value,
      href: value
    ,
    author: 
      name:  $t: value ,
      uri:  $t: value ,
      email:  $t: value ,
      gd$image: 
        rel: value,
        width: value,
        height: value,
        src: value
      
    ,
    generator: 
      version: value,
      uri: value,
      $t: value
    ,
    openSearch$totalResults:  $t: value ,
    openSearch$startIndex:  $t: value ,
    openSearch$itemsPerPage:  $t: value ,
    entry: 
      id:  $t: value ,
      published:  $t: value ,
      updated:  $t: value ,
      app$control: 
        xmlns$app: value,
        app$draft:  $t: value 
      ,
      category: 
        scheme: value,
        term: value
      ,
      title: 
        type: value,
        $t: value
      ,
      summary or content:  $t: value ,
      link: 
        rel: value,
        type: value,
        href: value,
        title: value,
        length: value
      ,
      author: 
        name: value,
        uri: value,
        email: value,
        gd$image: 
          rel: value,
          width: value,
          height: value,
          src: value
        
      ,
      media$thumbnail: 
        xmlns$media: value,
        url: value,
        width: value,
        height: value
      ,
      thr:  total$t: value ,
      georss: 
        featurename:  $t: value ,
        point:  $t: value ,
        box:  $t: value 
      
    
  

Liste des pages


  version: value,
  encoding: value,
  feed: 
    xmlns: value,
    xmlns$openSearch: value,
    xmlns$gd: value,
    id:  $t: value ,
    updated:  $t: value ,
    title: 
      type: value,
      $t: value
    ,
    subtitle: 
      type: value,
      $t: value
    ,
    link: 
      rel: value,
      type: value,
      href: value
    ,
    author: 
      name:  $t: value ,
      uri:  $t: value ,
      email:  $t: value ,
      gd$image: 
        rel: value,
        width: value,
        height: value,
        src: value
      
    ,
    generator: 
      version: value,
      uri: value,
      $t: value
    ,
    openSearch$totalResults:  $t: value ,
    openSearch$startIndex:  $t: value ,
    openSearch$itemsPerPage:  $t: value ,
    entry: 
      id:  $t: value ,
      published:  $t: value ,
      updated:  $t: value ,
      app$control: 
        xmlns$app: value,
        app$draft:  $t: value 
      ,
      title: 
        type: value,
        $t: value
      ,
      content:  $t: value ,
      link: 
        rel: value,
        type: value,
        href: value,
        title: value,
        length: value
      ,
      author: 
        name: value,
        uri: value,
        email: value,
        gd$image: 
          rel: value,
          width: value,
          height: value,
          src: value
        
      ,
      media$thumbnail: 
        xmlns$media: value,
        url: value,
        width: value,
        height: value
      
    
  

Liste des commentaires


  version: value,
  encoding: value,
  feed: 
    xmlns: value,
    xmlns$openSearch: value,
    xmlns$blogger: value,
    xmlns$gd: value,
    id:  $t: value ,
    updated:  $t: value ,
    title: 
      type: value,
      $t: value
    ,
    link: 
      rel: value,
      type: value,
      href: value
    ,
    author: 
      name:  $t: value ,
      uri:  $t: value ,
      email:  $t: value ,
      gd$image: 
        rel: value,
        width: value,
        height: value,
        src: value
      
    ,
    generator: 
      version: value,
      uri: value,
      $t: value
    ,
    openSearch$totalResults:  $t: value ,
    openSearch$startIndex:  $t: value ,
    openSearch$itemsPerPage:  $t: value ,
    entry: 
      id:  $t: value ,
      published:  $t: value ,
      updated:  $t: value ,
      title: 
        type: value,
        $t: value
      ,
      summary or content:  $t: value ,
      link: 
        rel: value,
        type: value,
        href: value,
        title: value,
        length: value
      ,
      author: 
        name: value,
        uri: value,
        email: value,
        gd$image: 
          rel: value,
          width: value,
          height: value,
          src: value
        
      ,
      thr: 
        in-reply-to: 
          xmlns$thr: value,
          href: value,
          ref: value,
          source: value,
          type: value
        
      ,
      gd$extendedProperty: 
        name: value,
        value: value
      
    
  

Article (GET)


  version: value,
  encoding: value,
  entry: 
    xmlns: value,
    xmlns$blogger: value,
    xmlns$georss: value,
    xmlns$gd: value,
    xmlns$thr: value,
    id:  $t: value ,
    published:  $t: value ,
    updated:  $t: value ,
    app$control: 
      xmlns$app: value,
      app$draft:  $t: value 
    ,
    category: 
      scheme: value,
      term: value
    ,
    title: 
      type: value,
      $t: value
    ,
    summary or content:  $t: value ,
    link: 
      rel: value,
      type: value,
      href: value,
      title: value,
      length: value
    ,
    author: 
      name: value,
      uri: value,
      email: value,
      gd$image: 
        rel: value,
        width: value,
        height: value,
        src: value
      
    ,
    media$thumbnail: 
      xmlns$media: value,
      url: value,
      width: value,
      height: value
    ,
    thr:  total$t: value ,
    georss: 
      featurename:  $t: value ,
      point:  $t: value ,
      box:  $t: value 
    
  

Page (GET)


  version: value,
  encoding: value,
  entry: 
    xmlns: value,
    xmlns$gd: value,
    id:  $t: value ,
    published:  $t: value ,
    updated:  $t: value ,
    app$control: 
      xmlns$app: value,
      app$draft:  $t: value 
    ,
    title: 
      type: value,
      $t: value
    ,
    content:  $t: value ,
    link: 
      rel: value,
      type: value,
      href: value,
      title: value,
      length: value
    ,
    author: 
      name: value,
      uri: value,
      email: value,
      gd$image: 
        rel: value,
        width: value,
        height: value,
        src: value
      
    ,
    media$thumbnail: 
      xmlns$media: value,
      url: value,
      width: value,
      height: value
    
  

Commentaire (GET)


  version: value,
  encoding: value,
  entry: 
    xmlns: value,
    xmlns$gd: value,
    id:  $t: value ,
    published:  $t: value ,
    updated:  $t: value ,
    title: 
      type: value,
      $t: value
    ,
    summary or content:  $t: value ,
    link: 
      rel: value,
      type: value,
      href: value,
      title: value,
      length: value
    ,
    author: 
      name: value,
      uri: value,
      email: value,
      gd$image: 
        rel: value,
        width: value,
        height: value,
        src: value
      
    ,
    thr: 
      in-reply-to: 
        xmlns$thr: value,
        href: value,
        ref: value,
        source: value,
        type: value
      
    ,
    gd$extendedProperty: 
      name: value,
      value: value
    
  



Récapitualtif des principales données

Tableau des données générales des flux (feed)

Item/Description Blogs Posts Pages Comments
feed.id.$t

Identifiant du flux.

Oui Oui Oui Oui
feed.updated.$t

Date de la mise à jour.

Oui Oui Oui Oui
feed.category[]

Liste des libellés du blog.

Non Oui Non Non
feed.category[i].term

Nom du libellé.

Non Oui Non Non
feed.title.$t

Titre du flux.

Oui Oui Oui Oui
feed.subtitle.$t

Description du blog.

Non Oui Oui Non
feed.link[]

Liste de liens.

Oui Oui Oui Oui
feed.link[i].rel

Relation du lien.

Oui Oui Oui Oui
feed.link[i].href

URL du lien.

Oui Oui Oui Oui
feed.author[]

Propriétaire du flux.

Oui Oui Oui Oui
feed.author[i].name.$t

Nom.

Oui Oui Oui Oui
feed.author[i].uri.$t

URL du profil.

Oui Oui Oui Oui
feed.author[i].gd$image.src

URL de l'image du profil.

Oui Oui Oui Oui
feed.openSearch$totalResults.$t

Nombre total d'entrées.

Oui Oui Oui Oui
feed.openSearch$startIndex.$t

Numéro de la première entrée de la page.

Oui Oui Oui Oui
feed.openSearch$itemsPerPage.$t

Nombre d'entrées par page.

Oui Oui Oui Oui

Tableau des entrées (entry)

Item/Description Blogs Posts Pages Comments
entry.id.$t

identifiant de l'entrée.

Oui Oui Oui Oui
entry.published.$t

Date de la publication.

Oui Oui Oui Oui
entry.updated.$t

Date de la mise à jour.

Oui Oui Oui Oui
entry.category[]

Liste des libellés de l'entrée.

Oui Oui Non Non
entry.category[i].term

Nom du libellé.

Oui Oui Non Non
entry.title.$t

Titre de l'entrée.

Oui Oui Oui Oui
entry.summary.$t

Contenu de l'entrée (Résumé).

Oui Oui Non Oui
entry.content.$t

Contenu de l'entrée.

Non Oui Oui Oui
entry.link[]

Liste des liens de l'entrée.

Oui Oui Oui Oui
entry.link[i].rel

Relation du lien.

Oui Oui Oui Oui
entry.link[i].href

URL du lien.

Oui Oui Oui Oui
entry.author[]

Auteur de l'entrée.

Oui Oui Oui Oui
entry.author[i].name.$t

Nom.

Oui Oui Oui Oui
entry.author[i].uri.$t

URL du profil.

Oui Oui Oui Oui
entry.author[i].gd$image.src

URL de l'image du profil.

Oui Oui Oui Oui
entry.media$thumbnail.url

Url de la vignette de l'entrée.

Non Oui Oui Non
entry.thr.total$t

Nombre de commentaires.

Non Oui Non Non
entry.thr.[in-reply-to]

Données du commentaire parent.

Non Non Non Oui
entry.thr.[in-reply-to].ref

Identifiant du commentaire parent.

Non Non Non Oui
entry.thr.[in-reply-to].href

URL du commentaire parent.

Non Non Non Oui
entry.thr.[in-reply-to].source

URL api du commentaire parent.

Non Non Non Oui
entry.georss

Données de localisation attribué à l'entrée.

Non Oui Non Non
entry.georss.featurename.$t

Nom de la localisation.

Non Oui Non Non
entry.georss.point.$t

Coordonnées de la localisation.

Non Oui Non Non
entry.georss.box.$t

Coordonnées de la localisation.

Non Oui Non Non

entry.gd$extendedProperty[]

entry.gd$extendedProperty[i].name

entry.gd$extendedProperty[i].value

Informations complémentaires de l'entrée.

Oui Non Non Oui


Exemple d'extraction Javascript JSON

L'exemple ci-dessous extrait quelques données du blog et les données de la dernière entrée de certains flux de liste.

Exemple

<script style="text/javascript">

function extraction(toto) {
  document.write('<b>Titre du blog</b> : '+toto.feed.title.$t+'<br/>');
  document.write('<b>Créateur du blog</b> : '+toto.feed.author[0].name.$t+'<br/>');

  for (var uneboucle = 0; uneboucle < 1; uneboucle++) {
    document.write('<b>Titre de la dernière entrée</b> : '+toto.feed.entry[uneboucle].title.$t+'<br/>');
  };
}

</script>

<h2>Extraction flux des articles</h2>
<script src="https://www.blogger.com/feeds/BLOG_ID/posts/default?alt=json-in-script&callback=extraction"></script>

<h2>Extraction flux des articles avec le libellé: "LABEL_NAME"</h2>
<script src="https://www.blogger.com/feeds/BLOG_ID/posts/default?category=LABEL_NAME&alt=json-in-script&callback=extraction"></script>

<h2>Extraction flux des articles avec la requête: "QUERY_NAME"</h2>
<script src="https://www.blogger.com/feeds/BLOG_ID/posts/default?q=QUERY_NAME&alt=json-in-script&callback=extraction"></script>

<h2>Extraction flux des pages</h2>
<script src="https://www.blogger.com/feeds/BLOG_ID/pages/default?alt=json-in-script&callback=extraction"></script>

<h2>Extraction flux des commentaires</h2>
<script src="https://www.blogger.com/feeds/BLOG_ID/comments/default?alt=json-in-script&callback=extraction"></script>

Résultat

Extraction flux des articles


Extraction flux des articles avec le libellé: "FAQ"


Extraction flux des articles avec la requête: "toto"


Extraction flux des pages statiques


Extraction flux des commentaires

Pas de chance. Blogger Code n'accepte plus les commentaires sur le blog.


Liens utiles



Les autres types de pages et vues d'un blog

Spotlight

Populaires cette semaine

Le fichier XML du gadget FeaturedPost