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.
Table des matières
- Les types de flux
- Liste des URL des flux d'extraction
- Réglage du résumé du contenu
- Méthode 1 : Via le tableau de bord du blog
- Méthode 2 : En modifiant le répertoire /default dans l'url du flux
- Paramètres additionnels des url des flux
- Disponibilité des paramètres additionnels
- Représentations JSON des données
- Récapitualtif des principales données
- Exemple d'extraction Javascript JSON
- Liens utiles
Les types de flux
Blogger met à la disposition des administrateurs de blogs, 3 types de flux.
Type | URI | Description |
---|---|---|
Flux du blog |
|
Flux destinés à la syndication du blog sur le web. Peuvent être également utilisés pour le développement web. |
API blogger.com (Blogger V2) |
|
Flux réservés aux administrateurs de blogs, destinés à un usage public ou privé. Sont utilisés pour le développement web. La version 2.0 de l'API Google Data n'est plus prise en charge depuis le 30 septembre 2024. |
API Google (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 |
|
Pages - LIST |
|
Commentaires Blog - LIST |
|
Commentaires Article - LIST |
|
Flux blogger.com
Contenu | URI |
---|---|
Articles - LIST |
|
Pages - LIST |
|
Commentaires Blog - LIST |
|
Commentaires Article - LIST |
|
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). |
|
/summary |
Résumé - Contient uniquement les 200 premiers caractères de l'article. |
|
/full |
Complet - Contient l'intégralité de l'article. |
|
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 :
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
Autres types : |
max-results |
Nombre maximum d'entrées Par défaut : 25 Maximum : 200 |
orderby |
Ordre des entrées
|
published-min
published-max
|
Horodatage - Date de publication Filtre les entrées à partir des dates de publication. Format : |
updated-min
updated-max
|
Horodatage - Date de mise à jour Filtre les entrées à partir des dates des mises à jour. Format : Remarque : Le paramètre est ignoré si la valeur de |
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 ( 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 |
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 Note : Attention aux caractères spéciaux qui sont susceptibles d'être introduit dans la requête : |
redirect |
Redirection Empêche une éventuelle redirection, par exemple vers Feedburners. Valeur : |
Disponibilité des paramètres additionnels
Paramètres | Posts - LIST | Pages - LIST | Comments Blog - LIST | Comments Post - LIST |
---|---|---|---|---|
category
q
|
Oui | Non | Non | Non |
max-results |
Oui | Oui | Oui | Oui |
orderby |
Oui | Oui | Oui | Oui |
published-min
published-max
updated-min
updated-max
|
Oui | Oui | Oui | Oui |
start-index |
Oui | Oui | Oui | Oui |
callback
redirect
alt
|
Oui | Oui | Oui | Oui |
Représentations JSON des données
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
Récapitualtif des principales données
Tableau des données générales des flux (feed)
Item/Description | Posts | Pages | Comments |
---|---|---|---|
feed.id.$t
Identifiant du flux. |
Oui | Oui | Oui |
feed.updated.$t
Date de la mise à jour. |
Oui | Oui | Oui |
feed.category[]
Liste des libellés du blog. |
Oui | Non | Non |
feed.category[i].term
Nom du libellé. |
Oui | Non | Non |
feed.title.$t
Titre du flux. |
Oui | Oui | Oui |
feed.subtitle.$t
Description du blog. |
Oui | Oui | Non |
feed.link[]
Liste de liens. |
Oui | Oui | Oui |
feed.link[i].rel
Relation du lien. |
Oui | Oui | Oui |
feed.link[i].href
URL du lien. |
Oui | Oui | Oui |
feed.author[]
Propriétaire du flux. |
Oui | Oui | Oui |
feed.author[i].name.$t
Nom. |
Oui | Oui | Oui |
feed.author[i].uri.$t
URL du profil. |
Oui | Oui | Oui |
feed.author[i].gd$image.src
URL de l'image du profil. |
Oui | Oui | Oui |
feed.openSearch$totalResults.$t
Nombre total d'entrées. |
Oui | Oui | Oui |
feed.openSearch$startIndex.$t
Numéro de la première entrée de la page. |
Oui | Oui | Oui |
feed.openSearch$itemsPerPage.$t
Nombre d'entrées par page. |
Oui | Oui | Oui |
Tableau des entrées (entry)
Item/Description | Posts | Pages | Comments |
---|---|---|---|
entry.id.$t
identifiant de l'entrée. |
Oui | Oui | Oui |
entry.published.$t
Date de la publication. |
Oui | Oui | Oui |
entry.updated.$t
Date de la mise à jour. |
Oui | Oui | Oui |
entry.category[]
Liste des libellés de l'entrée. |
Oui | Non | Non |
entry.category[i].term
Nom du libellé. |
Oui | Non | Non |
entry.title.$t
Titre de l'entrée. |
Oui | Oui | Oui |
entry.summary.$t
Contenu de l'entrée (Résumé). |
Oui | Non | Oui |
entry.content.$t
Contenu de l'entrée. |
Oui | Oui | Oui |
entry.link[]
Liste des liens de l'entrée. |
Oui | Oui | Oui |
entry.link[i].rel
Relation du lien. |
Oui | Oui | Oui |
entry.link[i].href
URL du lien. |
Oui | Oui | Oui |
entry.author[]
Auteur de l'entrée. |
Oui | Oui | Oui |
entry.author[i].name.$t
Nom. |
Oui | Oui | Oui |
entry.author[i].uri.$t
URL du profil. |
Oui | Oui | Oui |
entry.author[i].gd$image.src
URL de l'image du profil. |
Oui | Oui | Oui |
entry.media$thumbnail.url
Url de la vignette de l'entrée. |
Oui | Oui | Non |
entry.thr.total$t
Nombre de commentaires. |
Oui | Non | Non |
entry.thr.[in-reply-to]
Données du commentaire parent. |
Non | Non | Oui |
entry.thr.[in-reply-to].ref
Identifiant du commentaire parent. |
Non | Non | Oui |
entry.thr.[in-reply-to].href
URL du commentaire parent. |
Non | Non | Oui |
entry.thr.[in-reply-to].source
URL api du commentaire parent. |
Non | Non | Oui |
entry.georss
Données de localisation attribué à l'entrée. |
Oui | Non | Non |
entry.georss.featurename.$t
Nom de la localisation. |
Oui | Non | Non |
entry.georss.point.$t
Coordonnées de la localisation. |
Oui | Non | Non |
entry.georss.box.$t
Coordonnées de la localisation. |
Oui | Non | Non |
Informations complémentaires de l'entrée. |
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
<div id='blog-info'/>
<script style="text/javascript">
function extraction(data) {
if (!data.feed) {
document.getElementById("blog-info").innerHTML = "<p><b>Erreur :</b> Flux introuvable.</p>";
return;
}
let html = `
<p><b>Titre du blog :</b> ${data.feed.title.$t}</p>
<p><b>Créateur :</b> ${data.feed.author[0].name.$t}</p>
`;
if (data.feed.entry && data.feed.entry.length > 0) {
html += `<p><b>Titre de la dernière entrée :</b> ${data.feed.entry[0].title.$t}</p>`;
} else {
html += `<p><b>Aucune entrée trouvée.</b></p>`;
}
document.getElementById("blog-info").innerHTML = html;
}
function loadBloggerFeed(blogId, type = "posts", label = "", query = "") {
const script = document.createElement("script");
let url = `https://www.blogger.com/feeds/${blogId}/${type}/default?alt=json-in-script&callback=extraction`;
if (label) url += `&category=${encodeURIComponent(label)}`;
if (query) url += `&q=${encodeURIComponent(query)}`;
script.src = url;
script.async = true;
document.body.appendChild(script);
}
const BLOG_ID = "YOUR_BLOG_ID";
loadBloggerFeed(BLOG_ID);
</script>
Résultat
Titre du blog : Blogger Code PE Créateur : Soraya Lambrechts Titre de la dernière entrée : Introduction : Search Engine Optimization (SEO) |
Liens utiles
Un complément sur le blog d'aide Blogger en Français
Les articles du centre d'aide Blogger
Une documentation détaillée sur Google Developers
Google Developers - Blogger - Guide de référence [En anglais]