Nous mettons à jour les API YouTube Analytics et YouTube Reporting pour qu'elles correspondent à la façon dont YouTube comptabilise les vues des Shorts.
En savoir plus
Method jobs.reports.get
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Récupère les métadonnées d'un rapport spécifique.
Requête
Requête HTTP
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports/{reportId}
Autorisation
Toutes les requêtes envoyées à l'API YouTube Reporting 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 requêtes 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 sur votre contenu YouTube. Ce champ d'application permet d'accéder aux métriques d'activité des utilisateurs, comme le nombre de vues et le nombre d'évaluations. |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
Consultez les rapports YouTube Analytics sur les revenus de votre contenu YouTube. Cette portée permet d'accéder aux métriques sur l'activité des utilisateurs, ainsi qu'aux métriques sur les revenus estimés et les performances des annonces. |
Paramètres
Paramètres de chemin d'accès
| Paramètres |
jobId |
string
Identificateur utilisé par YouTube pour identifier de manière unique la tâche associée au rapport récupéré. |
reportId |
string
Identificateur utilisé par YouTube pour identifier de manière unique le rapport récupéré. |
Paramètres de requête
| Paramètres |
onBehalfOfContentOwner |
string
Identificateur du propriétaire du contenu pour lequel la requête API est effectuée. Si la requête ne spécifie pas de valeur pour ce paramètre, le serveur d'API suppose que la requête est effectuée pour le canal de l'utilisateur. |
Corps de la requête
Le corps de la requête doit être vide.
Réponse
Si la requête aboutit, le corps de la réponse contient une ressource Report.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/05/08 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/05/08 (UTC)."],[[["This endpoint retrieves metadata for a specific report using its `jobId` and `reportId`."],["Authorization is required for all requests, utilizing OAuth 2.0 and specific scopes like `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`."],["Path parameters `jobId` and `reportId` are required to identify the job and the report being retrieved."],["The `onBehalfOfContentOwner` query parameter allows specifying a content owner ID, otherwise, the request defaults to the user's own channel."],["A successful response returns a `Report` resource containing the report's metadata."]]],["This describes how to retrieve metadata for a specific YouTube report using the Reporting API. A `GET` request is sent to a URL containing the `jobId` and `reportId`. Authorization is required using OAuth 2.0, with scopes for viewing analytics and/or monetary reports. The request can also specify a `content owner` using `onBehalfOfContentOwner`. The request body is empty. A successful response returns a `Report` resource.\n"]]
