ThéorieFonctionnalitésAvancé

Flux - Protocole des données Blogger


Les posts publiés avant juin 2015 sont susceptibles de contenir des informations obsolètes !
Référez-vous à la nouvelle théorie du langage XML ou/et posez vos questions sur le forum pour en savoir plus.
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 http://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. Ne peuvent pas être employés pour la syndication du blog sur le web.
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...


Haut de page


Liste des URL des flux d'extraction

Contenu Type Origine URI
blogs ? list Blog -
Blogger https://www.blogger.com/feeds/PROFILE_ID/blogs
posts list Blog http://BLOG_NAME.blogspot.com/feeds/posts/default
Blogger ? https://www.blogger.com/feeds/BLOG_ID/posts/default
get Blog -
Blogger ? https://www.blogger.com/feeds/BLOG_ID/posts/default/POST_ID
pages ? list Blog http://BLOG_NAME.blogspot.com/feeds/pages/default
Blogger ? https://www.blogger.com/feeds/BLOG_ID/pages/default
get Blog -
Blogger ? https://www.blogger.com/feeds/BLOG_ID/pages/default/POST_ID
comments blog list Blog http://BLOG_NAME.blogspot.com/feeds/comments/default
Blogger https://www.blogger.com/feeds/BLOG_ID/comments/default
post list Blog http://BLOG_NAME.blogspot.com/feeds/POST_ID/comments/default
Blogger https://www.blogger.com/feeds/BLOG_ID/POST_ID/comments/default
get Blog -
Blogger https://www.blogger.com/feeds/BLOG_ID/POST_ID/comments/default/COMMENT_ID
archive ? - Blog -
Blogger https://www.blogger.com/feeds/BLOG_ID/archive/full


Haut de page


Réglage du résumé du contenu

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

Via le tableau de bord du blog

  • Tableau de bord
  • Paramètres
  • Autre
  • Autoriser les flux de blog

Sélectionnez l'une des options disponibles : Complet, Jusqu'au marqueur d'expansion (uniquement article), Partiel ou Aucun

En modifiant le répertoire default dans l'url du flux

Répertoire Signification Exemple
default Applique le réglage paramétré depuis l'interface http://BLOG_NAME.blogspot.com/feeds/posts/default
summary Résumé - Reprend les 200 premiers caractères du contenu http://BLOG_NAME.blogspot.com/feeds/posts/summary
full Complet - Reprend l'intégralité du contenu http://BLOG_NAME.blogspot.com/feeds/posts/full

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


Haut de page


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
http://BLOG_NAME.blogspot.com/feeds/posts/default?max-results=36&orderby=updated

Paramètres Significations
callback Appel fonction javascript
alt Type de représentation : alt=atom (par defaut) ou alt=rss.
Autres types :
  • alt=json
  • alt=json-in-script
  • alt=atom-in-script
  • alt=rss-in-script
  • alt=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 Défini une période à partir des dates de publication.
Format : 2012-10-24T23:59:59
published-max
updated-min Défini une période à partir des dates de mises à jour.
Format : 2012-10-24T23:59:59
Le paramètre est ignoré si ordeby est égale à updated.
updated-max
start-index Débute la sélection à partir de la Xeme entrée. Par défaut : 1
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 Empêche une éventuelle redirection. Par exemple vers Feedburners.
Valeur : false ou true


Haut de page


Disponibilité des paramètres additionnels

Contenu Type category ou q max-results orderby published-min,
published-max
ou
updated-min,
updated-max
start-index callback, redirect et alt
blogs list
posts list
get
pages list
get
comments blog list
post list
get


Haut de page


Représentations JSON des données

Choisir une représentation :

{
  "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 : only blogger.com feed */
        "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
          }
        }
      }
    ]
  }
}


Haut de page


Tableaux des principales données

Tableau des données générales des flux (feed)
Nom Description Disponibilité flux type liste
Blogs Posts Pages Comments
feed.id.$t identifiant du flux
feed.updated.$t Date de la mise à jour
feed.category[] Liste des libellés du blog
feed.category[i].term Nom du libellé
feed.title.$t Titre du flux
feed.subtitle.$t Description du blog
feed.link[] Liste de liens
feed.link[i].rel Relation du lien
feed.link[i].href URL du lien
feed.author[] Propriétaire du flux
feed.author[i].name.$t Nom
feed.author[i].uri.$t URL du profil
feed.author[i].gd$image.src URL de l'image du profil
feed.openSearch$totalResults.$t Nombre total d'entrées
feed.openSearch$startIndex.$t Numéro de la première entrée de la page
feed.openSearch$itemsPerPage.$t Nombre d'entrées par page

Tableau des entrées (entry)
Nom Description Disponibilité
Blogs Posts Pages Comments
entry.id.$t identifiant de l'entrée
entry.published.$t Date de la publication
entry.updated.$t Date de la mise à jour
entry.category[] Liste des libellés de l'entrée
entry.category[i].term Nom du libellé
entry.title.$t Titre de l'entrée
entry.summary.$t Contenu de l'entrée. Résumé ou Complet.
entry.content.$t
entry.link[] Liste des liens de l'entrée
entry.link[i].rel Relation du lien
entry.link[i].href URL du lien
entry.author[] Auteur de l'entrée
entry.author[i].name.$t Nom
entry.author[i].uri.$t URL du profil
entry.author[i].gd$image.src URL de l'image du profil
entry.media$thumbnail.url Url de la vignette de l'entrée
entry.thr.total$t Nombre de commentaires
entry.thr.[in-reply-to] Données du commentaire parent
entry.thr.[in-reply-to].ref Identifiant du commentaire parent
entry.thr.[in-reply-to].href URL du commentaire parent
entry.thr.[in-reply-to].source URL api du commentaire parent
entry.georss Données de localisation attribué à l'entrée
entry.georss.featurename.$t Nom de la localisation
entry.georss.point.$t Coordonnées de la localisation
entry.georss.box.$t Coordonnées de la localisation
entry.gd$extendedProperty[] Informations complémentaires de l'entrée.
entry.gd$extendedProperty[i].name
entry.gd$extendedProperty[i].value


Haut de page


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.

<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é: "Développements"

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.


Haut de page


Liens utiles

Vous trouverez de nombreux exemples de gadgets utilisant les flux Blogger sur Le blog de Prac.

Un complément sur le blog d'aide Blogger en Français : Flux rss : Quelques explications.

Les articles du centre d'aide Blogger : Flux et diffusion

Une documentation détaillée sur Google Developers :
Dernière modification :
Assistance publique pour le produit Blogger sur les Forums d'aides :

Certifiée par Google - Experte TC :
  • Affectation Google France, produit Blogger, du 11/07/2011 au 28/07/2014.
  • Affectation Google US, produit Blogger depuis le 28/07/2014.

Posts les plus consultés de ce blog

DéveloppementsMulti-versions
Facebook : Bouton J'aime [Like button]
Populaire
ThéorieRéférences XMLParamètres des données
Le paramètre Image redimensionnable [isResizable]
Populaire
DéveloppementsFichiers XML
Résumés des articles avec images réactives [Pack 2016]
Populaire