Qu'est-ce qu'une taxonomie ?
Une taxonomie est un objet décrivant une étiquette associée à un contenu (diffusion ou émission). Cette étiquette comprend toujours un type (thème ou tag), un intitulé (title), et une description (standFirst).
Sur l'Open API, deux types de taxonomies sont disponibles :
Les thèmes : il existe trois niveaux de thèmes (thème, sous-thème, sous-sous-thème).
Par exemple, une page de thème sur la plateforme Radio France peut être consultée à l'adresse suivante : https://www.radiofrance.fr/sciences-savoirs. On peut identifier le chemin du thème en observant la partie science-savoirs dans l'URL. Cette thématique peut comporter plusieurs sous-thèmes sous les chemins sciences-savoirs/philosophie ou encore sciences-savoirs/histoire.
astuceLes pages de thème sont reconnaissables car elles proposent généralement des sous-thèmes.
Les slashs présents dans le chemin indiquent la hiérarchie d'un thème.
Les tags : il s'agit généralement d'un mot-clé associé à un contenu. En prenant l'exemple d'une diffusion, on peut remarquer en bas de la page une liste de mots-clés cliquables, parmi lesquels figure le tag Forêt. Ce dernier redirige vers une page listant toutes les diffusions associées à ce mot-clé.
Contrairement aux thèmes, il n'existe pas de hiérarchie pour les tags.
Il existe deux ensembles de taxonomies : l'un pour les stations France Bleu et l'autre pour le reste des marques. Ces dernières sont distinguables en sélectionnant la source dans la requête GraphQL "taxonomies", comme indiqué ci-dessous.
Lister les dix premières taxonomies
{
taxonomies(source: UNIFIED, first: 10) {
edges {
cursor
node {
id
path
type
title
standFirst
}
}
}
}
Réponse de la requête
{
"data": {
"taxonomies": {
"edges": [
{
"cursor": "MQ==",
"node": {
"id": "0002545a-6f7a-461a-9a9d-557a08e6aafc_0",
"path": "sciences-savoirs/sciences-sociales/sociologie",
"type": "theme",
"title": "Sociologie",
"standFirst": " "
}
},
{
"cursor": "Mg==",
"node": {
"id": "0074d1d8-3618-11e1-a6ab-842b2b72cd1d_1",
"path": "dossiers/usa-2012-les-primaires",
"type": "dossier",
"title": "USA 2012 : les primaires",
"standFirst": null
}
},
{
"cursor": "Mw==",
"node": {
"id": "00769a73-2df5-43ec-a514-1d632fe9a5b1_5",
"path": "dossiers/eric-rohmer-l-integrale-en-cinq-entretiens-2004",
"type": "dossier",
"title": "Eric Rohmer, l'intégrale en cinq entretiens (2004)",
"standFirst": null
}
},
{
"cursor": "NA==",
"node": {
"id": "008aa4ec-6a9e-480e-a5e6-7433ca1e2612_5",
"path": "dossiers/la-nuit-speciale-feydeau-13-par-philippe-garbit",
"type": "dossier",
"title": "La Nuit spéciale - Feydeau 1/3 Par Philippe Garbit",
"standFirst": null
}
},
{
"cursor": "NQ==",
"node": {
"id": "00a6cd5a-9dd8-11e1-a502-842b2b72cd74_1",
"path": "dossiers/le-nouveau-gouvernement-cazeneuve-6-decembre-2016",
"type": "dossier",
"title": "Le nouveau gouvernement Cazeneuve - 6 décembre 2016",
"standFirst": null
}
},
{
"cursor": "Ng==",
"node": {
"id": "00d82e97-7aec-4572-9f83-61cba47db749_0",
"path": "sujets/tsiganes-roms",
"type": "tag",
"title": "Tsiganes – Roms",
"standFirst": null
}
},
{
"cursor": "Nw==",
"node": {
"id": "0107ffb2-3a40-4d67-af58-db1ed2079e64_0",
"path": "sujets/chasse",
"type": "tag",
"title": "Chasse",
"standFirst": null
}
},
{
"cursor": "OA==",
"node": {
"id": "010c22fb-6cee-4a10-a404-c32a31056b89_5",
"path": "dossiers/atelier-de-creation-radiophonique",
"type": "dossier",
"title": "Atelier de Création Radiophonique",
"standFirst": null
}
},
{
"cursor": "OQ==",
"node": {
"id": "011bc873-7431-4710-8460-f6c81fa1e155_0",
"path": "sujets/emirats-arabes-unis",
"type": "tag",
"title": "Émirats Arabes Unis",
"standFirst": " "
}
},
{
"cursor": "MTA=",
"node": {
"id": "011cb498-bc0a-4a3e-953a-0b47f6fb3470_5",
"path": "dossiers/nuit-cop-24-par-philippe-garbit",
"type": "dossier",
"title": "Nuit COP 24, Par Philippe Garbit",
"standFirst": null
}
}
]
}
}
}
Récupérer la référence d'une taxonomie par son chemin
Exemple pour un sous thème:
{
taxonomies(source: UNIFIED, paths: ["sciences-savoirs/sciences"]) {
edges {
cursor
node {
id
path
type
title
standFirst
}
}
}
}
Réponse de la requête
{
"data": {
"taxonomies": {
"edges": [
{
"cursor": "MQ==",
"node": {
"id": "cc6810e9-da63-4398-b8b6-efccd8d089da_0",
"path": "sciences-savoirs/sciences",
"type": "theme",
"title": "Sciences",
"standFirst": "Écoutez des podcasts de sciences : biologie, physique, astronomie, mathématiques, géographie, archéologie... Vous pourrez comprendre les sciences par des entretiens avec les scientifiques d'aujourd'hui, apprendre l'histoire des sciences et connaître l'actualité de la recherche scientifique."
}
}
]
}
}
}
Récupérer des diffusions à partir d'une ou plusieurs taxonomies
Prenons l'exemple où nous souhaitons avoir uniquement les contenus liés au thème de la politique. Nous pourrions récupérer l'identifiant du thème en effectuant une requête sur la query taxonomies, puis exécuter la requête suivante :
{
diffusions(
station: FRANCEINTER
themes: ["f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0"]
) {
edges {
cursor
node {
id
title
standFirst
url
published_date
taxonomiesConnection {
edges {
node {
id
path
title
}
}
}
}
}
}
}
Réponse de la requête
{
"data": {
"diffusions": {
"edges": [
{
"cursor": "MQ==",
"node": {
"id": "52ff3a44-55b2-401b-9ce9-7364ea69d801_1",
"title": "Thomas Piketty et Philippe Manière : Argentine, les enseignements de l'élection de Javier Milei",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/le-debat-du-7-10/le-debat-du-7-10-du-mardi-21-novembre-2023-3460671",
"published_date": "1700553980",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "90a83929-c886-414e-a3b7-82b6c08908b4_0",
"path": "politique/democratie-et-vie-citoyenne",
"title": "Vie citoyenne"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "Mg==",
"node": {
"id": "ffb84f4d-a1fe-4ee1-8990-c4be8421d649_1",
"title": "L'Invité de 7H50 du mardi 21 novembre 2023",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/l-invite-de-7h50/l-invite-de-7h50-du-mardi-21-novembre-2023-9305095",
"published_date": "1700549340",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "cd07ffad-cb10-4f6b-9020-2668d539fa89_0",
"path": "info",
"title": "Info"
}
},
{
"node": {
"id": "ef694d8a-2ca2-4d45-bcb2-cc87cebbff8d_0",
"path": "societe",
"title": "Société"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "Mw==",
"node": {
"id": "1cc39a72-12d7-4856-b4a3-12e7a856e14e_1",
"title": "IA : votre robot conversationnel est-il militant ?",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/l-edito-politique/l-edito-politique-du-mardi-21-novembre-2023-5718865",
"published_date": "1700549010",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "NA==",
"node": {
"id": "2d560a9e-0e68-4ae1-bde1-4872c3000905_1",
"title": "La question migratoire, carburant des populistes en Europe",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/dominique-reynie-en-toute-subjectivite/dominique-reynie-en-toute-subjectivite-du-mardi-21-novembre-2023-2023080",
"published_date": "1700547590",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "90a83929-c886-414e-a3b7-82b6c08908b4_0",
"path": "politique/democratie-et-vie-citoyenne",
"title": "Vie citoyenne"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "NQ==",
"node": {
"id": "6b4221eb-eef2-4402-a8fa-31efbd09f15d_1",
"title": "Trump, modèle ambigu pour Marine Le Pen",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/histoires-politiques/histoires-politiques-du-mardi-21-novembre-2023-3148840",
"published_date": "1700545340",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
}
]
}
}
}
Si il s'agit d'un sous-thème, veillez à remplacer l'argument theme par subtheme ou par subsubtheme si il s'agit d'un thème de troisième niveau.
Example de récupération de diffusions par sous thème:
{
# sous theme: politique/democratie-et-vie-citoyenne
diffusions(
station: FRANCEINTER
subthemes: ["90a83929-c886-414e-a3b7-82b6c08908b4_0"]
) {
edges {
cursor
node {
id
title
standFirst
url
published_date
taxonomiesConnection {
edges {
node {
id
path
title
}
}
}
}
}
}
}
Réponse de la requête
{
"data": {
"diffusions": {
"edges": [
{
"cursor": "MQ==",
"node": {
"id": "52ff3a44-55b2-401b-9ce9-7364ea69d801_1",
"title": "Thomas Piketty et Philippe Manière : Argentine, les enseignements de l'élection de Javier Milei",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/le-debat-du-7-10/le-debat-du-7-10-du-mardi-21-novembre-2023-3460671",
"published_date": "1700553980",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "90a83929-c886-414e-a3b7-82b6c08908b4_0",
"path": "politique/democratie-et-vie-citoyenne",
"title": "Vie citoyenne"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "Mg==",
"node": {
"id": "2d560a9e-0e68-4ae1-bde1-4872c3000905_1",
"title": "La question migratoire, carburant des populistes en Europe",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/dominique-reynie-en-toute-subjectivite/dominique-reynie-en-toute-subjectivite-du-mardi-21-novembre-2023-2023080",
"published_date": "1700547590",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "90a83929-c886-414e-a3b7-82b6c08908b4_0",
"path": "politique/democratie-et-vie-citoyenne",
"title": "Vie citoyenne"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
}
]
}
}
}
Chacun des filtres est exclusif, fonctionnant selon des opérations logiques ET plutôt que des opérations logiques OU.