YouTube Reporting API

L'API YouTube Reporting permet aux développeurs de planifier des tâches de création de rapports, puis de télécharger des rapports groupés générés. L'API est compatible avec un ensemble prédéfini de rapports, chacun contenant un ensemble complet de données YouTube Analytics pour une chaîne ou un propriétaire de contenu.

Pour planifier des tâches de création de rapports et récupérer des rapports, procédez comme suit:

  1. Appelez la méthode reportTypes.list() pour récupérer la liste des rapports qu'une chaîne ou un propriétaire de contenu peut récupérer.
  2. Appelez la méthode jobs.create() pour identifier un rapport à générer pour une chaîne ou un propriétaire de contenu. Vous pouvez ensuite utiliser jobs.list() et jobs.delete() de l'API pour récupérer ou modifier la liste des rapports générés.
  3. Appelez la méthode jobs.reports.list() pour récupérer la liste des rapports générés pour une tâche donnée. Chaque ressource de la réponse contient une propriété downloadUrl qui spécifie l'URL à partir de laquelle le rapport peut être téléchargé.
  4. Envoyez une requête GET autorisée pour récupérer le rapport à partir de l'URL de téléchargement.

Autorisation

Toutes les requêtes de l'API de création de rapports YouTube doivent être autorisées. Le guide d'autorisation explique comment utiliser le protocole OAuth 2.0 pour récupérer des jetons d'autorisation.

Les demandes de l'API YouTube Reporting utilisent les champs d'application d'autorisation suivants:

Niveaux d'accès
https://www.googleapis.com/auth/yt-analytics.readonly Affichez les rapports YouTube Analytics relatifs à votre contenu YouTube. Elle permet d'accéder aux métriques d'activité des utilisateurs, comme le nombre de vues et d'avis.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Affichez les rapports monétaires YouTube Analytics relatifs à votre contenu YouTube. Elle permet d'accéder aux métriques d'activité des utilisateurs, ainsi qu'aux métriques sur les revenus estimés et les performances des annonces.

Types de ressources

Les sections suivantes fournissent une description générale des ressources et méthodes de l'API. Tous les URI de méthodes affichés dans les tables sont relatifs à https://youtubereporting.googleapis.com.

tâches

Méthodes
create POST /v1/jobs
Crée une tâche de création de rapports. En créant une tâche de reporting, vous demandez à YouTube de générer ce rapport quotidiennement. Le rapport est disponible dans les 24 heures suivant la création de l'offre d'emploi.
delete DELETE /v1/jobs/{jobId}
Supprime une tâche de reporting.
get GET /v1/jobs/{jobId}
Récupère des informations sur une tâche de création de rapports spécifique qui a été planifiée pour une chaîne ou un propriétaire de contenu.
list GET /v1/jobs
Répertorie les tâches de rapport qui ont été planifiées pour une chaîne ou un propriétaire de contenu. Chaque ressource de la réponse contient une propriété id, qui spécifie l'ID utilisé par YouTube pour identifier l'offre d'emploi de manière unique. Vous avez besoin de cet ID pour récupérer la liste des rapports générés pour la tâche ou pour la supprimer.

jobs.reports

Méthodes
get GET /v1/jobs/{jobId}/reports/{reportId}
Récupère les métadonnées d'un rapport spécifique.
list GET /v1/jobs/{jobId}/reports
Répertorie les rapports générés pour la tâche de création de rapports spécifiée.

reportTypes

Méthodes
list GET /v1/reportTypes
Renvoie la liste des types de rapports que la chaîne ou le propriétaire de contenu peut récupérer.