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 :
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 | 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 |
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
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]
Les autres types de pages et vues d'un blog
- Les articles et pages autonomes
- L'accueil et les pages recherche
- Les archives
- Les pages 404
- La vue mobile
- La prévisualisation
- La vue de mise en page
- Les vues alternatives
- Les vues par langue
- Les flux du blog