Flux - Protocole des données Blogger

Nous remettons à jour notre base de connaissances. Cette fiche fera bientôt l'objet d'une révision.

!!! RAPPEL !!! Seuls les partenaires de Blogger-Code-PE disposent d'une licence spécifique sur notre propriété intellectuelle. Si vous n'êtes pas partenaire, vous n'êtes pas autorisé à recopier, à reproduire ou à traduire le contenu de ce blog sur un support public (blog, site web, forum, livre, e-book, etc...), ce qui inclut, sauf mention contraire, les textes, les codes, les listes des données, les illustrations, les syntaxes, les tableaux, etc... La violation de ces règles est passible de poursuites judiciaires. Conditions d'utilisation du blog.

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...

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

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.

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

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						✓

Représentations JSON des données

Choisir une représentation : Liste des blogs Liste des articles Liste des pages autonomes Liste des commentaires Un article Une page autonome Un commentaire

{
  "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
          }
        ]
      }
    ]
  }
}
{
  "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
          }
        }
      }
    ]
  }
}
{
  "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 : only blogger.com feed */
        "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
        }
      }
    ]
  }
}
{
  "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
          }
        ]
      }
    ]
  }
}
{
  "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 : 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
      }
    }
  }
}
{
  "version": value,
  "encoding": value,
  "entry": {
    "xmlns": value,
    "xmlns$gd": value,
    "id": {
      "$t": value
    },
    "published": {
      "$t": value
    },
    "updated": {
      "$t": value
    },
    /* app$control : only blogger.com feed */
    "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
    }
  }
}
{
  "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
      }
    ]
  }
}

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

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.

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 :

• 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

Retourner à l'introduction