Cette page répertorie les modifications apportées à l'API et à la documentation concernant l'API YouTube Reporting et l'API YouTube Analytics. Ces deux API permettent aux développeurs d'accéder aux données YouTube Analytics, mais de manière différente. S'abonner à ce journal des modifications
4 décembre 2023
L'API YouTube Analytics (Targeted Query) a été mise à jour afin de fusionner deux valeurs de dimension insightTrafficSourceType
. Auparavant, la dimension différenciait les vidéos lues dans une playlist (PLAYLIST
) et les vues provenant d'une page répertoriant toutes les vidéos d'une playlist (YT_PLAYLIST_PAGE
). À l'avenir, les deux types de vues seront associés à la valeur de la dimension PLAYLIST
.
15 décembre 2022
L'API (requêtes ciblées) de YouTube Analytics accepte deux nouvelles dimensions et un nouveau rapport:
-
Un nouveau rapport indique l'activité des utilisateurs par ville. Ce rapport est disponible pour les chaînes et les propriétaires de contenu. Ce rapport contient la nouvelle dimension
city
, qui identifie une estimation par YouTube de la ville où l'utilisateur a effectué l'activité. -
La nouvelle dimension
creatorContentType
identifie le type de contenu YouTube associé aux métriques sur l'activité des utilisateurs dans la ligne de données. Les valeurs acceptées sontLIVE_STREAM
,SHORTS
,STORY
etVIDEO_ON_DEMAND
.La dimension
creatorContentType
est disponible en tant que dimension facultative pour tous les rapports sur les chaînes et les propriétaires de contenu sur les vidéos. -
Le guide des exemples de demandes de l'API YouTube Analytics inclut désormais des exemples pour les deux nouvelles dimensions.
-
Les références aux dimensions
7DayTotals
et30DayTotals
ont été supprimées de la documentation. L'abandon de ces dimensions a été annoncé en octobre 2019.
26 août 2022
Les API YouTube Analytics (requêtes ciblées) et YouTube Reporting (rapports groupés) sont toutes deux compatibles avec une nouvelle valeur de détail pour les sources de trafic:
- Dans l'API YouTube Analytics (requêtes ciblées), si la valeur de la dimension
insightTrafficSourceType
estSUBSCRIBER
, la valeurinsightTrafficSourceDetail
peut être définie surpodcasts
, ce qui indique que le trafic provient de la page de destination Podcasts. - Dans l'API YouTube Reporting (rapports groupés), si la valeur de la dimension
traffic_source_type
est3
, la valeurtraffic_source_detail
peut être définie surpodcasts
, ce qui indique que le trafic provient de la page de destination Podcasts.
11 février 2022
L'ensemble des valeurs valides pour la dimension gender
va changer le 11 août 2022 ou après cette date. Il peut s'agir d'une modification de l'implémentation de votre API qui empêcherait la rétrocompatibilité. Conformément à la section Modifications incompatibles des conditions d'utilisation des services d'API YouTube, cette modification est annoncée six mois avant son entrée en vigueur. Veuillez mettre à jour l'implémentation de votre API avant le 11 août 2022 pour assurer une transition fluide vers le nouvel ensemble de valeurs.
Voici les modifications spécifiques apportées:
- Dans l'API YouTube Analytics (requêtes ciblées), la dimension
gender
accepte actuellement deux valeurs:female
etmale
. À compter du 11 août 2022, cette dimension acceptera trois valeurs:female
,male
etuser_specified
. - Dans l'API de création de rapports YouTube (rapports groupés), la dimension
gender
accepte actuellement trois valeurs:FEMALE
,MALE
etGENDER_OTHER
. À partir du 11 août 2022, l'ensemble des valeurs acceptées seraFEMALE
,MALE
etUSER_SPECIFIED
.
9 février 2022
Deux métriques ont été mises à jour pour exclure le trafic des extraits en boucle depuis le 13 décembre 2021. Cette modification affecte à la fois l'API YouTube Analytics (requêtes ciblées) et l'API YouTube Reporting (rapports groupés).
- Dans l'API YouTube Analytics (requêtes ciblées), les métriques
averageViewDuration
etaverageViewPercentage
excluent toutes deux le trafic des extraits en boucle depuis le 13 décembre 2021. - Dans l'API YouTube Reporting (rapports groupés), les métriques
average_view_duration_seconds
etaverage_view_duration_percentage
excluent toutes deux le trafic des extraits en boucle depuis le 13 décembre 2021.
2 février 2022
L'API YouTube Reporting (rapports groupés) accepte une nouvelle valeur de dimension "Source de trafic" qui indique que les vues proviennent de Live Redirect:
- Dans l'API YouTube Reporting (rapports groupés), la dimension
traffic_source_type
accepte la valeur28
.
Pour ce type de source de trafic, la dimension traffic_source_detail
spécifie l'ID de la chaîne d'où provient le spectateur.
23 septembre 2020
L'API YouTube Analytics (requêtes ciblées) et l'API YouTube Reporting (rapports groupés) sont toutes deux compatibles avec une nouvelle valeur de dimension "Source de trafic" qui indique que le spectateur a été redirigé verticalement dans l'expérience de visionnage YouTube Shorts:
- Dans l'API YouTube Analytics (requêtes ciblées), la dimension
insightTrafficSourceType
accepte la valeurSHORTS
. - Dans l'API YouTube Reporting (rapports groupés), la dimension
traffic_source_type
accepte la valeur24
.
La dimension "Détails de la source de trafic" (insightTrafficSourceDetail
dans l'API YouTube Analytics ou traffic_source_detail
dans l'API YouTube Reporting) n'est pas renseignée pour ce nouveau type de source de trafic.
20 juillet 2020
Cette mise à jour concerne deux modifications qui affectent l'API (requêtes ciblées) de YouTube Analytics:
- La taille maximale d'un groupe de rapports YouTube Analytics est passée de 200 à 500 entités.
- Le paramètre
filters
de la méthodereports.query
identifie une liste de filtres à appliquer lors de la récupération des données YouTube Analytics. Ce paramètre permet de spécifier plusieurs valeurs pour les filtresvideo
,playlist
etchannel
. Le nombre maximal d'ID pouvant être spécifiés pour ces filtres est passé de 200 à 500.
13 février 2020
Cette mise à jour contient les modifications suivantes concernant l'API YouTube Analytics (requêtes ciblées) et l'API YouTube Reporting (rapports groupés). Pour en savoir plus sur ces modifications, consultez le Centre d'aide YouTube.
Dans les deux API, l'ensemble des valeurs possibles des détails des sources de trafic pour les notifications change.
Dans les requêtes ciblées, les notifications sont signalées par la mention insightTrafficSourceType=NOTIFICATION
. Dans les rapports groupés, les notifications sont signalées par la mention traffic_source_type=17
.
Les nouvelles valeurs répartissent les notifications liées aux vidéos mises en ligne et aux diffusions en direct (auparavant signalées par uploaded
) en deux catégories:
uploaded_push
: vues provenant de notifications push envoyées aux abonnés lors de la mise en ligne d'une vidéouploaded_other
: vues provenant de notifications non push (par e-mail ou dans la boîte de réception, par exemple) envoyées aux abonnés lors de la mise en ligne d'une vidéo.
Ces valeurs sont renvoyées pour la période commençant le 13 janvier 2020 (13 janvier 2020).
Pour rappel, ces valeurs ne représentent pas les notifications elles-mêmes, mais plutôt les sources de trafic ayant généré certaines vues YouTube. Par exemple, si une ligne de rapport indique views=3
, traffic_source_type=17
(NOTIFICATION
) et traffic_source_detail=uploaded_push
, elle indique que trois vues sont générées par des utilisateurs qui ont cliqué sur des notifications push envoyées lors de la mise en ligne de la vidéo.
15 octobre 2019
Cette mise à jour inclut les modifications suivantes liées à l'API (requêtes ciblées) de YouTube Analytics:
-
Remarque:Il s'agit d'une annonce d'abandon.
Les dimensions
7DayTotals
et30DayTotals
ne seront bientôt plus acceptées par YouTube. Vous pourrez récupérer les données à l'aide de ces dimensions jusqu'au 15 avril 2020. À cette date ou après, toute tentative de récupération de rapports à l'aide de la dimension7DayTotals
ou30DayTotals
renverra une erreur.Notez que les utilisateurs peuvent reproduire certaines données pour ces dimensions en effectuant des requêtes à l'aide de la dimension
day
, et en agrégeant ou en extrayant les données sur des périodes de 7 ou 30 jours. Exemple :- Le nombre de vues sur une période de sept jours peut être calculé en cumulant le nombre de vues enregistrées pour chaque jour de cette période.
- La valeur "ViewerPercentage" pour une période de sept jours peut être calculée en multipliant le nombre de vues enregistrées chaque jour par le nombre de personnes qui ont visionné la vidéo un jour donné. Le résultat correspond au nombre de spectateurs qui étaient connectés au moment de regarder la vidéo ce jour-là. Vous pouvez ensuite ajouter le nombre de spectateurs connectés pour l'ensemble de la période et le diviser par le nombre total de vues pour cette période afin d'obtenir le pourcentage de spectateurs pour l'ensemble de la période.
- Impossible de calculer le nombre de spectateurs uniques pendant une période de sept jours, car un même spectateur peut être comptabilisé comme un spectateur unique à différents jours. Toutefois, vous pouvez utiliser la dimension
month
au lieu de la dimension30DayTotals
pour extrapoler les données sur le nombre de spectateurs uniques sur une période de 30 jours. Notez que la dimensionmonth
fait référence aux mois calendaires, tandis que la dimension30DayTotals
calcule les périodes de 30 jours en fonction des dates de début et de fin spécifiées.
27 juin 2019
Cette mise à jour inclut les modifications suivantes liées à l'API (requêtes ciblées) de YouTube Analytics:
-
La version 1 de l'API étant désormais complètement obsolète, la documentation a été mise à jour pour supprimer les références à cette version, y compris l'avis d'abandon et le guide de migration expliquant comment passer à la version 2.
1er novembre 2018
Cette mise à jour inclut les modifications suivantes liées à l'API (requêtes ciblées) de YouTube Analytics:
-
La version 1 de l'API est désormais obsolète. Si vous ne l'avez pas déjà fait, veuillez mettre à jour vos clients API afin qu'ils utilisent la version 2 de l'API dès que possible afin de limiter les interruptions de service. Pour en savoir plus, consultez le guide de migration.
Notez que le calendrier d'abandon a été initialement annoncé le 26 avril 2018.
17 septembre 2018
Cette mise à jour inclut les modifications suivantes liées à l'API (requêtes ciblées) de YouTube Analytics:
-
La nouvelle section sur l'anonymisation des données dans la présentation du modèle de données explique que certaines données YouTube Analytics sont limitées lorsque les métriques n'atteignent pas un certain seuil. Cela peut se produire dans divers cas. En pratique, cela signifie qu'un rapport peut ne pas contenir toutes vos données (ou une partie d'entre elles) si:
-
le trafic d'une vidéo ou d'une chaîne est limité pendant une période donnée ;
ou
-
vous avez sélectionné un filtre ou une dimension, comme "Source de trafic" ou "Pays", pour lesquels les valeurs n'atteignent pas un certain seuil.
Elle aborde également les types de données susceptibles d'être limitées dans les rapports YouTube Analytics.
-
-
Les rapports sur les chaînes et les rapports sur les propriétaires de contenu ont été mis à jour pour tenir compte du fait que les métriques
redViews
etestimatedRedMinutesWatched
ne sont plus compatibles avec les rapports sur les contextes de lecture, les sources de trafic et les types d'appareils/systèmes d'exploitation.
18 juin 2018
Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Analytics (requêtes ciblées) :
- Les exigences de champ d'application pour les méthodes suivantes ont changé :
- Les requêtes envoyées à la méthode
reports.query
doivent avoir accès au champ d'applicationhttps://www.googleapis.com/auth/youtube.readonly
. - Les requêtes envoyées à la méthode
groupItems.list
doivent avoir accès à :- le champ d'application
https://www.googleapis.com/auth/youtube
ou - le champ d'application
https://www.googleapis.com/auth/youtube.readonly
et
le champ d'applicationhttps://www.googleapis.com/auth/yt-analytics.readonly
La première option utilise un champ d'application, qui se trouve être en lecture/écriture, tandis que la seconde utilise deux champs d'application en lecture seule.
- le champ d'application
- Les requêtes envoyées à la méthode
23 mai 2018
Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Analytics (requêtes ciblées) :
- La présentation de l'API contient une nouvelle section, Métriques agrégées et éléments supprimés, qui explique comment les réponses de l'API traitent les données associées aux ressources supprimées, telles que les vidéos, les playlists ou les chaînes.
- La section Bonnes pratiques de la présentation de l'API a été mise à jour pour vous rappeler que vous pouvez utiliser l'API YouTube Data pour récupérer des métadonnées supplémentaires pour les ressources identifiées dans les réponses de l'API YouTube Analytics. Conformément aux Règles pour les développeurs des services d'API YouTube (sections III.E.4.b à III.E.4.d), les clients API doivent supprimer ou actualiser les métadonnées de ressources stockées de cette API après 30 jours.
22 mai 2018
Cette mise à jour contient les modifications suivantes liées à l'API de création de rapports YouTube (rapports groupés) :
- Les modifications suivantes sont actuellement prévues pour juillet 2018. Les nouvelles règles s'appliquent à l'ensemble des rapports et des tâches de création de rapports.
-
Après la modification, la plupart des rapports de l'API, y compris ceux sur les remplissages, seront disponibles pendant 60 jours à compter de leur génération. Toutefois, les rapports contenant des données historiques sont disponibles pendant 30 jours à partir du moment où ils sont générés.
Avant cette annonce, tous les rapports d'API étaient disponibles pendant 180 jours à compter de leur création. Sachez que lorsque cette nouvelle règle entrera en vigueur, les rapports sur les données historiques datant de plus de 30 jours ne seront plus accessibles via l'API. De plus, tous les autres rapports datant de plus de 60 jours ne seront plus accessibles. Par conséquent, la documentation indique désormais que les rapports créés avant la modification des règles seront disponibles jusqu'à 180 jours.
-
Après la modification, lorsque vous planifiez une tâche de création de rapports, YouTube génère des rapports à partir de ce jour et couvrant la période de 30 jours précédant l'heure de planification de la tâche. Avant la modification, lorsque vous planifiez une tâche de création de rapports, YouTube génère des rapports couvrant la période de 180 jours précédant l'heure à laquelle la tâche a été planifiée.
-
-
La section Bonnes pratiques a été mise à jour pour vous rappeler que vous pouvez utiliser l'API YouTube Data pour récupérer des métadonnées supplémentaires pour les ressources identifiées dans les rapports. Conformément aux Règles pour les développeurs des services d'API YouTube (sections III.E.4.b à III.E.4.d), les clients API doivent supprimer ou actualiser les métadonnées de ressources stockées de cette API après 30 jours.
-
La section Caractéristiques des rapports a été mise à jour pour indiquer que, même si les données des rapports ne sont pas filtrées, les rapports qui contiennent des données pour une période à compter du 1er juin 2018 ne contiennent aucune référence à des ressources YouTube supprimées au moins 30 jours avant la date de création du rapport.
-
La section Données historiques de la présentation de l'API a été mise à jour pour indiquer que lorsque vous planifiez une nouvelle tâche de création de rapports, les rapports historiques sont généralement publiés au bout de quelques jours. Auparavant, la documentation indiquait qu'il pouvait s'écouler jusqu'à 30 jours avant que ces rapports soient disponibles.
-
La section Données de remplissage de la présentation de l'API a été mise à jour afin de définir plus clairement les données de remplissage comme un ensemble de données qui remplace un ensemble déjà diffusé.
26 avril 2018
La version 2 de l'API (requêtes ciblées) de YouTube Analytics (version 2) est désormais accessible au public. La liste suivante répertorie les modifications apportées au produit et à la documentation liées à la nouvelle version de l'API:
-
La version 2 de l'API est presque identique à la version 1 de l'API. Toutefois, vous devrez probablement mettre à jour votre code pour refléter les modifications répertoriées ci-dessous. Tous ces changements sont décrits en détail dans le nouveau guide de migration.
- La version de l'API est passée de
v1
àv2
. - L'URL de base des requêtes API est passée de
https://www.googleapis.com/youtube/analytics/v1
àhttps://youtubeanalytics.googleapis.com/v2
. - Plusieurs paramètres de la méthode
reports.query
ont des noms mis à jour. Plus précisément, les noms de paramètres contenant des traits d'union, commeend-date
dans l'API v1, utilisent Camel Case ("casse de chameau") (endDate
) plutôt que des traits d'union dans la version 2 de l'API. Cette modification assure la cohérence des noms de paramètres dans l'ensemble de l'API, car les méthodes de l'API pour la création et la gestion des groupes utilisaient déjà la casse mixte pour les noms de paramètres. - La version 2 n'est pas compatible avec les requêtes par lot envoyées au point de terminaison HTTP par lot de Google (
www.googleapis.com/batch
). Si vous envoyez des requêtes par lot dans la version 2, vous devez utiliser le point de terminaisonhttps://youtubeanalytics.googleapis.com/v2
à la place.
En outre, quelques fonctionnalités de la version 1 ne sont pas compatibles avec la version 2 de l'API:
- La méthode
reports.query
n'accepte plus les paramètres de requêtealt
,quotaUser
etuserIp
. - La version 2 de l'API ne fournit pas de point de terminaison par lot compatible avec les lots constitués de requêtes adressées à différentes API. Notez qu'un lot peut être constitué de requêtes adressées à différentes méthodes de la même API. Cet abandon n'est pas spécifique à l'API YouTube Analytics, car Google abandonne le point de terminaison mondial des lots pour toutes ses API.
- La version 2 de l'API n'est pas compatible avec le protocole JSON-RPC, qui était compatible avec la version 1 de l'API. Là encore, cet abandon n'est pas spécifique à l'API YouTube Analytics.
- La version de l'API est passée de
-
Remarque:Il s'agit d'une annonce d'abandon.
La version 1 de l'API (v1) est désormais obsolète et sera compatible jusqu'au 31 octobre 2018. Après cette date, toutes les requêtes envoyées à l'API v1 cesseront de fonctionner. Par conséquent, assurez-vous de passer à la version 2 de l'API au plus tard le 31 octobre 2018 pour éviter toute interruption de votre accès aux données YouTube Analytics via l'API.
21 février 2018
Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Analytics (requêtes ciblées) :
- Les rapports sur les performances démographiques des spectateurs, qui regroupent les statistiques de visionnage en fonction de la tranche d'âge et du genre des spectateurs, n'acceptent plus la dimension
youtubeProduct
, qui identifie le service YouTube sur lequel l'activité des utilisateurs a eu lieu.
18 janvier 2018
Cette mise à jour inclut les changements suivants :
-
API YouTube Reporting (rapports groupés)
- La dimension
operating_system
, qui identifie le système logiciel de l'appareil sur lequel les vues ont eu lieu, accepte désormais la valeur suivante :25
: KaiOS
- La dimension
-
API YouTube Analytics (requêtes ciblées)
- La dimension
operatingSystem
accepte la valeurKAIOS
.
- La dimension
20 décembre 2017
Cette mise à jour inclut deux modifications liées à l'API YouTube Reporting:
-
Le serveur d'API est à présent compatible avec la compression gzip pour les requêtes de téléchargement de rapports. Notez que la compression gzip n'est pas compatible avec les autres types de requêtes API. L'activation de la compression gzip réduit la bande passante requise pour chaque réponse de l'API. Même si la décompression des réponses de l'API nécessite un temps CPU supplémentaire pour votre application, l'avantage de consommer moins de ressources réseau l'emporte généralement sur ce coût.
Pour recevoir une réponse encodée au format gzip, définissez l'en-tête de requête HTTP
Accept-Encoding
surgzip
, comme indiqué dans l'exemple suivant:Accept-Encoding: gzip
Cette fonctionnalité est expliquée dans la présentation de l'API et dans la définition de la propriété
downloadUrl
de la ressourcereport
. -
La documentation sur les dimensions
age group
etgender
a été corrigée pour afficher les valeurs réelles renvoyées par l'API pour ces dimensions. Notez qu'il s'agit d'une correction de la documentation et qu'elle ne reflète pas un changement au niveau des fonctionnalités ou du comportement de l'API. Plus précisément, les valeurs suivantes ont été modifiées:- Les valeurs de la dimension
age_group
utilisent des lettres majuscules, contiennent des traits de soulignement entre le motAGE
et les chiffres de la tranche d'âge, et utilisent des traits de soulignement au lieu de traits d'union. Par conséquent, des valeurs telles queage13-17
etage18-24
ont été corrigées respectivement enAGE_13_17
etAGE_18_24
. - Les valeurs de la dimension
gender
utilisent des lettres majuscules. Par conséquent, les valeursfemale
,male
etgender_other
ont été corrigées enFEMALE
,MALE
etGENDER_OTHER
.
- Les valeurs de la dimension
10 août 2017
Le 10 août 2016, cette documentation annonçait l'abandon de la métrique earnings
de l'API YouTube Analytics. Dans le même temps, l'API a ajouté la prise en charge d'une nouvelle métrique, nommée estimatedRevenue
, qui fournit les mêmes données.
La métrique earnings
étant une métrique essentielle, elle a été prise en charge pendant un an à compter de la date de l'annonce. Maintenant que cette période est terminée, la métrique earnings
n'est plus acceptée. Par conséquent, les requêtes API qui spécifient la métrique earnings
renvoient désormais un code de réponse HTTP 400
. Si vous n'avez pas encore mis à jour votre application afin d'utiliser la métrique estimatedRevenue
au lieu de la métrique earnings
, veuillez le faire dès que possible.
La documentation de l'API a été mise à jour pour supprimer les références restantes à la métrique earnings
.
6 juillet 2017
Cette mise à jour inclut les changements suivants :
-
API YouTube Analytics (requêtes ciblées)
-
La documentation de l'API a été mise à jour pour refléter le fait que les réponses de l'API contiennent des données remontant jusqu'au dernier jour de la plage de dates demandée pour laquelle toutes les métriques interrogées sont disponibles.
Par exemple, si une requête spécifie le 5 juillet 2017 comme date de fin et que les valeurs de toutes les métriques demandées ne sont disponibles que jusqu'au 3 juillet 2017, cette date sera la dernière à laquelle les données seront incluses dans la réponse. (même si les données de certaines métriques demandées sont disponibles pour le 4 juillet 2017).
-
La dimension
adType
est désormais compatible avec la valeurreservedBumperInstream
, qui désigne une annonce vidéo non désactivable d'une durée maximale de six secondes qui est lue avant qu'une vidéo puisse être visionnée. Le format d'annonce est identique à celui de l'annonceauctionBumperInstream
, mais ce type fait référence aux annonces vendues via un système de réservation plutôt que dans le cadre d'enchères.
-
-
API YouTube Reporting (rapports groupés)
-
La dimension
ad_type
accepte désormais la valeur20
, qui fait référence aux annonces bumper vendues par réservation. Les annonces bumper sont des annonces vidéo non désactivables de six secondes maximum qui sont diffusées avant le visionnage d'une vidéo. Notez que la valeur19
pour cette dimension fait également référence aux annonces bumper vendues via des enchères plutôt que par réservation. -
Les jobs de création de rapports pour les rapports suivants de l'API YouTube Reporting ont été supprimés:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
L'abandon de ces types de rapports a été annoncé le 15 septembre 2016. Ils n'ont plus été générés après le 15 décembre 2016. Les rapports précédemment générés sont toujours disponibles pendant 180 jours. Certains rapports sont donc accessibles depuis le 15 juin 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches qui leur sont associées ne sont pas non plus nécessaires.
-
24 mai 2017
Toutes les tâches de création de rapports pour les rapports suivants de l'API YouTube Reporting ont été supprimées:
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
Ces types de rapports ont été annoncés comme étant obsolètes le 22 juin 2016. Ils n'ont plus été générés après le 22 septembre 2016. Les rapports précédemment générés sont toujours disponibles pendant 180 jours. Certains rapports sont donc accessibles depuis le 22 mars 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches qui leur sont associées ne sont pas non plus nécessaires.
22 mai 2017
Cette mise à jour inclut les changements suivants :
-
API YouTube Reporting (rapports groupés)
- La dimension
sharing_service
, qui identifie le service utilisé pour partager des vidéos, accepte désormais les valeurs suivantes:85
: YouTube Music86
: YouTube Gaming87
: YouTube Kids88
: YouTube TV
De plus, le nom utilisé pour identifier la valeur
52
a été mis à jour dans la documentation en Kakao (Kakao Talk) pour la différencier plus clairement de la valeur73
(Kakao Story). Ce changement ne reflète aucun changement au niveau du comportement de l'API ni de la classification des vidéos partagées avec ces services.
- La dimension
-
API YouTube Analytics (requêtes ciblées)
- La dimension
sharingService
accepte désormais les valeurs suivantes:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- La dimension
28 mars 2017
Les propriétaires de chaînes qui peuvent accéder aux données sur les revenus via YouTube Analytics dans Creator Studio peuvent désormais également y accéder via l'API YouTube Analytics:
-
L'API accepte les métriques de revenus suivantes:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
Ces métriques sont compatibles avec les rapports suivants:
-
Les propriétaires de canaux peuvent désormais récupérer un rapport sur les performances des annonces, qui accepte les dimensions
adType
etday
(facultative). -
Le guide des exemples de demandes de l'API YouTube Analytics inclut désormais une section pour les rapports sur les revenus d'une chaîne.
17 mars 2017
Cette mise à jour inclut les changements suivants :
-
L'API YouTube Analytics est compatible avec les métriques
redViews
etestimatedRedMinutesWatched
, qui concernent toutes deux le nombre de spectateurs YouTube Red. En fait, l'API prend en charge ces métriques depuis un certain temps, et l'API YouTube Reporting est déjà compatible avec les deux, comme nous l'avons annoncé le 15 septembre 2016.- La métrique
redViews
indique le nombre de fois où une vidéo a été regardée par les membres YouTube Red. - La métrique
estimatedRedMinutesWatched
indique le nombre de minutes pendant lesquelles les membres YouTube Red ont regardé une vidéo.
La documentation concernant les rapports sur les chaînes et les rapports sur les propriétaires de contenu a été mise à jour pour indiquer quels rapports sont compatibles avec les deux nouvelles métriques. Elles le sont dans tous les rapports qui acceptent déjà les métriques
views
etestimatedMinutesWatched
. - La métrique
3 mars 2017
Cette mise à jour inclut les changements suivants :
-
API YouTube Reporting (rapports groupés)
-
La définition de la dimension
date
a été corrigée afin de noter que la valeur de la dimension fait référence à la période commençant à minuit (heure du Pacifique) et se terminant à 23h59 (heure du Pacifique) le jour, le mois et l'année spécifiés. En fonction de la période de l'année, l'heure du Pacifique est UTC-7 ou UTC-8.Bien que les dates représentent généralement une période de 24 heures, les dates pour lesquelles les horloges sont reculées représentent une période de 23 heures, tandis que les dates pour lesquelles les horloges sont reculées représentent une période de 25 heures. (Précédemment, la documentation indiquait que chaque date représentait une période unique de 24 heures et que l'heure du Pacifique était toujours UTC-8.)
Notez que cette correction ne modifie pas le comportement réel de l'API.
- La dimension
operating_system
, qui identifie le système logiciel de l'appareil sur lequel les vues ont eu lieu, accepte désormais les valeurs suivantes :22
: Tizen23
: Firefox24
: RealMedia
-
Toutes les tâches de création de rapports pour le type de rapport
content_owner_basic_a1
ont été supprimées. Ce type de rapport était complètement obsolète depuis le 19 août 2016, mais les rapportscontent_owner_basic_a1
générés auparavant étaient encore disponibles pendant 180 jours à compter de leur création. Certains rapports sont donc accessibles depuis le 19 février 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches qui leur sont associées ne sont pas non plus nécessaires.
-
-
API YouTube Analytics (requêtes ciblées)
-
La description des dimensions associées à "
time periods
" a été corrigée afin de noter que la valeur de la dimension fait référence à la période commençant à minuit (heure du Pacifique) et se terminant à 23h59 (heure du Pacifique) le jour, le mois et l'année spécifiés. En fonction de la période de l'année, l'heure du Pacifique est UTC-7 ou UTC-8.Bien que les dates représentent généralement une période de 24 heures, les dates pour lesquelles les horloges sont reculées représentent une période de 23 heures, tandis que les dates pour lesquelles les horloges sont reculées représentent une période de 25 heures. (Précédemment, la documentation indiquait que l'heure du Pacifique correspondait au fuseau UTC-8 et ne mentionnait pas la possibilité qu'un jour ne représente pas une période de 24 heures.)
Notez que cette correction ne modifie pas le comportement réel de l'API.
-
La documentation relative aux rapports sur les canaux a été mise à jour pour indiquer que ces rapports ne contiennent pas, pour le moment, les statistiques sur les revenus ni sur les performances des annonces. Par conséquent, le champ d'application
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
n'accorde actuellement pas l'accès aux données monétaires dans les rapports sur les canaux. - La dimension
operatingSystem
accepte trois nouvelles valeurs :FIREFOX
REALMEDIA
TIZEN
-
8 février 2017
L'API YouTube Analytics est désormais compatible avec le paramètre facultatif include-historical-channel-data
. Notez que ce paramètre n'est pertinent que pour la récupération des rapports sur les propriétaires de contenu.
Ce paramètre permet au propriétaire de contenu d'indiquer qu'une réponse de l'API doit inclure la durée de visionnage et les données sur les vues enregistrées par les chaînes pour la période précédant l'association des chaînes au propriétaire de contenu. La valeur par défaut du paramètre est false
. Cela signifie que, par défaut, la réponse de l'API n'inclut que les données sur la durée de visionnage et les vues de la période d'association des chaînes au propriétaire de contenu.
Ces règles s'appliquent également si la requête API récupère des données pour plusieurs canaux:
- Si la valeur du paramètre est
false
, les données sur la durée de visionnage et les vues affichées pour une chaîne donnée sont basées sur la date à laquelle elle a été associée au propriétaire de contenu.
N'oubliez pas que différentes chaînes peuvent avoir été associées à un propriétaire de contenu à différentes dates. Si la requête API récupère les données de plusieurs canaux et que la valeur du paramètre estfalse
, la réponse de l'API contient la durée de visionnage et les données de vue en fonction de la date d'association pour chaque canal. - Si la valeur du paramètre est
true
, la réponse renvoie la durée de visionnage et les données de vue de tous les canaux en fonction des dates de début et de fin spécifiées dans la requête API.
15 décembre 2016
Les rapports suivants de l'API YouTube Reporting ne sont plus acceptés et ont été supprimés de la documentation. Une version plus récente de chaque rapport est disponible. L'annonce de l'abandon de ces rapports a été faite le 15 septembre 2016.
-
Rapports sur les canaux
channel_basic_a1
: remplacé par le rapportchannel_basic_a2
.channel_province_a1
: remplacé par le rapportchannel_province_a2
.channel_playback_location_a1
: remplacé par le rapportchannel_playback_location_a2
.channel_traffic_source_a1
: remplacé par le rapportchannel_traffic_source_a2
.channel_device_os_a1
: remplacé par le rapportchannel_device_os_a2
.channel_subtitles_a1
: remplacé par le rapportchannel_subtitles_a2
.channel_combined_a1
: remplacé par le rapportchannel_combined_a2
.
-
Rapports du propriétaire de contenu
content_owner_basic_a2
: remplacé par le rapportcontent_owner_basic_a3
.content_owner_province_a1
: remplacé par le rapportcontent_owner_province_a2
.content_owner_playback_location_a1
: remplacé par le rapportcontent_owner_playback_location_a2
.content_owner_traffic_source_a1
: remplacé par le rapportcontent_owner_traffic_source_a2
.content_owner_device_os_a1
: remplacé par le rapportcontent_owner_device_os_a2
.content_owner_subtitles_a1
: remplacé par le rapportcontent_owner_subtitles_a2
.content_owner_combined_a1
: remplacé par le rapportcontent_owner_combined_a2
.content_owner_asset_basic_a1
: remplacé par le rapportcontent_owner_asset_basic_a2
.content_owner_asset_province_a1
: remplacé par le rapportcontent_owner_asset_province_a2
.content_owner_asset_playback_location_a1
: remplacé par le rapportcontent_owner_asset_playback_location_a2
.content_owner_asset_traffic_source_a1
: remplacé par le rapportcontent_owner_asset_traffic_source_a2
.content_owner_asset_device_os_a1
: remplacé par le rapportcontent_owner_asset_device_os_a2
.content_owner_asset_combined_a1
: remplacé par le rapportcontent_owner_asset_combined_a2
.
La liste des types de rapports actuels dans la documentation de référence de l'API a également été mise à jour.
11 novembre 2016
Cette mise à jour inclut les changements suivants :
-
Rapports sur les écrans de fin
- Le rapport sur les écrans de fin pour les vidéos d'une chaîne contient des statistiques sur toutes les vidéos d'une chaîne.
- Le rapport sur les écrans de fin pour les vidéos de propriétaires de contenu contient des statistiques sur les vidéos de toutes les chaînes d'un propriétaire de contenu.
- Le rapport sur les composants de propriétaire de contenu inclut des statistiques sur les éléments associés aux vidéos après lesquelles ces écrans s'affichent.
-
Dimensions des écrans de fin
end_screen_element_type
: type d'élément d'écran de fin associé aux statistiques.end_screen_element_id
: ID utilisé par YouTube pour identifier de façon unique l'élément d'écran de fin.
Métriques sur les écrans de fin
Remarque:Les données sur les métriques concernant les écrans de fin sont disponibles depuis le 1er mai 2016.
end_screen_element_impressions
: nombre total d'impressions d'éléments d'écran de fin. Une impression est enregistrée pour chaque élément d'écran de fin affiché.end_screen_element_clicks
: nombre de fois où les utilisateurs ont cliqué sur des éléments d'écran de finend_screen_element_click_rate
: taux de clics des éléments d'écran de fin.
-
Les rapports suivants ne sont plus acceptés et ont été supprimés de la documentation. Une version plus récente de chaque rapport est disponible. L'annonce de l'abandon de ces rapports a été faite le 22 juin 2016.
content_owner_ad_performance_a1
: remplacé par le rapportcontent_owner_ad_rates_a1
.content_owner_estimated_earnings_a1
: remplacé par le rapportcontent_owner_estimated_revenue_a1
.content_owner_asset_estimated_earnings_a1
: remplacé par le rapportcontent_owner_asset_estimated_revenue_a1
.
-
Les métriques de la liste suivante sont entièrement obsolètes et ne sont plus acceptées. Comme annoncé le 10 août 2016, de nouvelles métriques faisant référence aux mêmes données sont déjà acceptées. Le tableau ci-dessous indique les noms des métriques obsolètes et des nouveaux:
Métrique obsolète Nouvelle métrique adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Revenus publicitaires mensuels, mondiaux et par vidéo
- Revenus publicitaires quotidiens et par pays par vidéo
- Revenus publicitaires mensuels et mondiaux par élément
- Revenus publicitaires quotidiens et par pays par élément
- Revendications (ce rapport ne contient pas de données sur les revenus)
-
L'API est compatible avec deux nouvelles métriques liées au nombre de spectateurs YouTube Red:
red_views
: nombre de fois où une vidéo a été regardée par les membres YouTube Red.red_watch_time_minutes
: nombre de minutes pendant lesquelles les membres YouTube Red ont regardé une vidéo.
-
L'API est compatible avec les nouvelles versions de 20 rapports. Toutes les nouvelles versions sont compatibles avec les nouvelles métriques
red_views
etred_watch_time_minutes
.Pour chaque rapport, le nombre indiqué dans le nouvel ID de type de rapport est supérieur d'un à celui de l'ancien ID. Les anciennes versions de ces rapports sont désormais obsolètes, comme décrit plus loin dans cet historique des révisions. Par exemple, le rapport "
channel_basic_a1
" est désormais obsolète et a été remplacé par le rapport "channel_basic_a2
".Les listes suivantes identifient les nouveaux ID de type de rapport:
Rapports sur les vidéos des chaînes
Rapports sur les vidéos de propriétaires de contenu
Rapports sur les éléments du propriétaire de contenu
-
Remarque:Il s'agit d'une annonce d'abandon.
Notez que si vous disposez déjà de tâches permettant de créer l'une des anciennes versions des rapports répertoriés ci-dessus, vous devez créer de nouvelles tâches pour les rapports renommés. Depuis la publication de nouvelles versions des rapports, les versions suivantes ont été abandonnées:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Si vous avez des emplois pour l'un de ces rapports, ne vous attendez pas à ce que YouTube génère de nouveaux rapports pour ces emplois après le 15 décembre 2016. Les rapports générés sont toujours disponibles pendant 180 jours à compter de leur création.
-
Le rapport
content_owner_basic_a1
a été entièrement abandonné et supprimé de la documentation. YouTube ne générera plus de rapports de ce type. Toutefois, ceux qui ont déjà été générés restent disponibles pendant 180 jours à compter de leur création.Le rapport
content_owner_basic_a2
remplace le rapportcontent_owner_basic_a1
, comme expliqué dans l'entrée de l'historique des révisions du 19 mai 2016. -
Les nouvelles conditions d'utilisation des services d'API YouTube ("les Conditions mises à jour"), discutées en détail sur le blog des ingénieurs et des développeurs YouTube, incluent un grand nombre de mises à jour des conditions d'utilisation actuelles. En plus des Conditions mises à jour, qui entreront en vigueur le 10 février 2017, cette mise à jour comprend plusieurs documents justificatifs expliquant les règles que les développeurs doivent respecter.
L'ensemble complet des nouveaux documents est décrit dans l'historique des révisions des nouvelles Conditions d'utilisation. De plus, les modifications futures apportées aux Conditions mises à jour ou aux documents justificatifs seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS répertoriant les modifications apportées dans cet historique de révisions à partir d'un lien dans ce document.
-
API YouTube Analytics (requêtes ciblées)
-
Remarque:Il s'agit d'une annonce d'abandon.
Les métriques du tableau suivant vont être abandonnées. Parallèlement, de nouvelles métriques faisant référence aux mêmes données sont introduites. En effet, les anciennes métriques ont été renommées. Toutefois, l'API YouTube Analytics acceptera les deux noms de statistiques jusqu'aux dates d'abandon indiquées dans le tableau.
Ancien nom de la métrique Nom de la nouvelle métrique Date d'assistance earnings
estimatedRevenue
10 août 2017 adEarnings
estimatedAdRevenue
4 novembre 2016 redPartnerRevenue
estimatedRedPartnerRevenue
4 novembre 2016 impressionBasedCpm
cpm
4 novembre 2016 impressions
adImpressions
4 novembre 2016 Notez que la métrique
earnings
était une métrique principale. Elle sera donc disponible pendant un an à compter de la date de cette annonce. Les autres métriques, qui ne faisaient pas partie des métriques principales, seront disponibles pendant trois mois, jusqu'au 4 novembre 2016.Par exemple, jusqu'au 4 novembre 2016, une requête API peut spécifier la métrique
impressionBasedCpm
, la métriquecpm
ou les deux. Cependant, après cette date, seule la métriquecpm
sera acceptée. - La dimension
insightTrafficSourceType
accepte deux nouvelles valeurs :CAMPAIGN_CARD
: cette source de trafic n'est compatible qu'avec les rapports de propriétaire de contenu. Il indique que les vues proviennent de vidéos revendiquées et mises en ligne par des utilisateurs, et utilisées par le propriétaire de contenu pour promouvoir le contenu consulté.END_SCREEN
: les données concernent les vues provenant de l'écran de fin d'une autre vidéo.
Vous pouvez également obtenir un rapport
traffic source detail
pour les deux nouvelles sources de trafic. Dans les deux cas, la dimensioninsightTrafficSourceDetail
identifie la vidéo à partir de laquelle le spectateur a été redirigé. -
La dimension
adType
est désormais compatible avec la valeurauctionBumperInstream
, qui désigne une annonce vidéo non désactivable d'une durée maximale de six secondes qui est lue avant qu'une vidéo puisse être visionnée.
-
-
API YouTube Reporting (rapports groupés)
- La dimension
traffic_source_type
accepte désormais les valeurs suivantes :19
: cette source de trafic n'est compatible qu'avec les rapports de propriétaire de contenu. Il indique que les vues proviennent de vidéos revendiquées et mises en ligne par des utilisateurs, et utilisées par le propriétaire de contenu pour promouvoir le contenu consulté.20
: les données concernent les vues provenant de l'écran de fin d'une autre vidéo.
Pour les deux nouvelles sources de trafic, la dimension
traffic_source_detail
identifie la vidéo à partir de laquelle le spectateur a été redirigé. -
La liste des métriques principales de l'API a été corrigée pour répertorier
estimated_partner_revenue
en tant que métrique principale et supprimerearnings
de cette liste. (La métriqueearnings
n'a jamais été compatible avec l'API YouTube Reporting.) -
La dimension
ad_type
est désormais compatible avec la valeur19
qui fait référence aux annonces bumper. Il s'agit d'annonces vidéo non désactivables de six secondes maximum qui sont diffusées avant le visionnage d'une vidéo.
- La dimension
-
API YouTube Analytics (requêtes ciblées)
- Les listes des métriques acceptées pour les rapports sur les canaux suivants ont été mises à jour afin d'inclure les métriques des fiches. La prise en charge des métriques sur les fiches dans ces rapports a été ajoutée le 28 juin 2016, et l'entrée de l'historique des révisions pour cette date explique plus en détail ce changement. Ces rapports sont les suivants :
- Activité de base des utilisateurs dans les États américains
- Activité des utilisateurs dans les États américains pour des périodes spécifiques
- Activité des utilisateurs par province
- Activité des utilisateurs par état d'abonnement
- Activité des utilisateurs par état d'abonnement dans les provinces
- Top des vidéos par État
- Top des vidéos pour les spectateurs abonnés ou non
-
Les listes de filtres ont été corrigées dans les rapports sur la rétention d'audience de la chaîne et dans les rapports sur la rétention d'audience des propriétaires de contenu afin de refléter le fait que le filtre
video
est requis et que le filtregroup
n'est pas accepté.Auparavant, la documentation des deux rapports indiquait à tort que le rapport pouvait être récupéré à l'aide de l'un de ces deux filtres ou de l'un d'entre eux.
- Les listes des métriques acceptées pour les rapports sur les canaux suivants ont été mises à jour afin d'inclure les métriques des fiches. La prise en charge des métriques sur les fiches dans ces rapports a été ajoutée le 28 juin 2016, et l'entrée de l'historique des révisions pour cette date explique plus en détail ce changement. Ces rapports sont les suivants :
-
API YouTube Reporting (rapports groupés)
- Dans la présentation de l'API, la section expliquant comment extraire l'URL de téléchargement d'un rapport a été corrigée afin d'indiquer que YouTube génère des rapports téléchargeables pour les jours où aucune donnée n'était disponible. Ces rapports comportent une ligne d'en-tête, mais ne contiennent aucune donnée supplémentaire. Ces informations avaient déjà été mises à jour dans la section Caractéristiques du rapport du même document le 12 avril 2016.
- La liste des dimensions du rapport "
content_owner_asset_cards_a1
" a été corrigée pour refléter le fait que le rapport utilise la dimension "card_id
". Auparavant, la documentation présentait à tort le nom de la dimensioncard_title
.
- Statistiques de base(chaînes, propriétaires de contenu)
- Basé sur le temps(chaînes, propriétaires de contenu)
- Zone géographique de l'utilisateur (chaînes, propriétaires de contenu)
- Activité des utilisateurs par état d'abonnement (chaînes, propriétaires de contenu)
- Vidéos les plus regardées (chaînes, propriétaires de contenu)
-
La section Caractéristiques du rapport de la présentation de l'API a été mise à jour pour indiquer que les rapports sont disponibles via l'API pendant 180 jours à compter de leur génération.
Auparavant, la documentation indiquait que les rapports étaient disponibles pendant une période allant jusqu'à 180 jours avant la date d'envoi de la requête API. Même s'il est techniquement vrai, le texte original était, au mieux, plutôt déroutant.
-
L'API est compatible avec les nouvelles versions de trois rapports. Deux d'entre eux contiennent également de nouvelles métriques qui ont été renommées:
-
Le rapport
content_owner_ad_rates_a1
est la nouvelle version du rapportcontent_owner_ad_performance_a1
. Le rapport nouvellement renommé est identique à la version précédente. -
Deux rapports dont la version a été modifiée ont été renommés:
- La nouvelle version du rapport
content_owner_estimated_earnings_a1
s'appellecontent_owner_estimated_revenue_a1
. - La nouvelle version du rapport
content_owner_asset_estimated_earnings_a1
s'appellecontent_owner_asset_estimated_revenue_a1
.
Les deux nouveaux rapports renommés présentent plusieurs différences par rapport aux prédécesseurs:
- Il ajoute la nouvelle métrique
estimated_partner_red_revenue
, qui fournit une estimation du total des revenus issus des abonnements YouTube Red. - Il ajoute la nouvelle métrique
estimated_partner_transaction_revenue
, qui permet d'estimer les revenus issus des transactions, comme les contenus payants et le financement par les fans, moins les remboursements effectués par les partenaires. - Il renomme la métrique
estimated_partner_ad_sense_revenue
estimated_partner_ad_auction_revenue
. - Il renomme la métrique
estimated_partner_double_click_revenue
estimated_partner_ad_reserved_revenue
.
- La nouvelle version du rapport
Notez que si vous disposez déjà de tâches permettant de créer l'une des anciennes versions de ces rapports, vous devez créer de nouvelles tâches pour les rapports renommés. Parallèlement à la publication de nouvelles versions des rapports, les rapports
content_owner_ad_performance_a1
,content_owner_estimated_earnings_a1
etcontent_owner_asset_estimated_earnings_a1
ont été abandonnés.Si vous avez des emplois pour l'un de ces rapports, ne vous attendez pas à ce que YouTube génère de nouveaux rapports pour ces emplois après le 22 septembre 2016. Les rapports générés sont toujours disponibles pendant 180 jours à compter de leur création.
-
-
La définition de la propriété
id
de la ressourcereportType
a été mise à jour pour refléter l'ensemble actuel de rapports disponibles. -
Les noms de deux métriques ont été corrigés dans la documentation pour correspondre à ceux qui apparaissent dans les rapports. Il s'agit simplement d'une correction de la documentation et ne reflète pas un changement réel du contenu du rapport:
- Le nom de la métrique
estimated_partner_adsense_revenue
a été remplacé parestimated_partner_ad_sense_revenue
. Notez toutefois que cette métrique n'apparaît que dans deux rapports qui seront abandonnés avec cette mise à jour. Comme décrit ci-dessus, cette métrique a été renomméeestimated_partner_ad_auction_revenue
dans les versions plus récentes de ces rapports. - Le nom de la métrique
estimated_partner_doubleclick_revenue
a été remplacé parestimated_partner_double_click_revenue
. Encore une fois, notez que cette métrique n'apparaît que dans deux rapports qui vont être abandonnés avec cette mise à jour. Comme décrit ci-dessus, cette métrique a été renomméeestimated_partner_ad_reserved_revenue
dans les versions plus récentes de ces rapports.
- Le nom de la métrique
-
La documentation sur les dimensions de l'API Reporting a été mise à jour pour ne plus répertorier les propriétés
elapsed_video_time_percentage
etaudience_retention_type
. Ces dimensions ne sont actuellement pas compatibles avec les rapports disponibles via l'API. -
L'API est compatible avec une nouvelle version du rapport sur l'activité de l'utilisateur pour les propriétaires de contenu. L'ID du type du nouveau rapport est
content_owner_basic_a2
. Contrairement à la version précédente du rapport (content_owner_basic_a1
), la nouvelle version est compatible avec les métriqueslikes
etdislikes
.Si vous disposez déjà d'une tâche pour créer le rapport
content_owner_basic_a1
, vous devez tout de même créer une autre tâche pour le rapportcontent_owner_basic_a2
. YouTube ne migre pas automatiquement les propriétaires de contenu vers la nouvelle version du rapport et ne crée pas automatiquement une tâche pour générer la nouvelle version. Dans certaines implémentations, l'apparition d'une nouvelle tâche inattendue peut constituer une modification destructive.Parallèlement à la publication du nouveau rapport, le rapport "
content_owner_basic_a1
" a été obsolète. Si vous avez une tâche pour ce rapport, ne vous attendez pas à ce que YouTube génère de nouveaux rapports pour cette tâche après le 19 août 2016. Les rapports générés sont toujours disponibles pendant 180 jours à compter de leur création. -
Les ressources
reportType
,job
etreport
acceptent une nouvelle propriété qui détermine si la ressource associée représente un type de rapport obsolète:-
La propriété
deprecateTime
de la ressourcereportType
indique la date et l'heure auxquelles le type de rapport sera abandonné. Cette propriété ne comporte une valeur que pour les rapports annoncés comme obsolètes. La valeur représente la date à laquelle YouTube cessera de générer ce type de rapports.Une fois qu'un type de rapport est signalé comme obsolète, YouTube génère des rapports du même type pendant trois mois supplémentaires. Par exemple, cette mise à jour du 19 mai 2016 annonce l'abandon du rapport
content_owner_basic_a1
. Ainsi, l'attributdeprecateTime
de ce type de rapport indique une date précise au 19 août 2016. Passée cette date, YouTube cessera de générer des rapports de ce type. -
La propriété
expireTime
de la ressourcejob
spécifie la date et l'heure d'expiration ou d'expiration du job. Cette propriété est associée à une valeur si le type de rapport associé au job est obsolète ou si les rapports générés pour la tâche n'ont pas été téléchargés pendant une période prolongée. Cette date marque l'heure à laquelle YouTube ne génère plus de rapports pour cette mission. -
La propriété
jobExpireTime
de la ressourcereport
spécifie la date et l'heure auxquelles le job associé au rapport a expiré ou expirera. Cette propriété contient la même valeur que la propriétéexpireTime
de la ressourcejob
, comme décrit dans l'élément précédent de cette liste.
-
-
La méthode
jobs.create
renvoie désormais un code de réponse HTTP400
(Bad Request
) si vous essayez de créer une tâche pour un rapport obsolète. En outre, la documentation de la méthode répertorie maintenant plusieurs autres raisons pouvant expliquer l'échec d'une requête API. -
YouTube génère désormais des données couvrant la période de 180 jours précédant la planification initiale d'une tâche de création de rapports. Auparavant, l'API Reporting ne fournissait aucune donnée historique. Cette modification affecte toutes les tâches, y compris celles créées avant cette annonce.
Les rapports historiques sont publiés dès qu'ils sont disponibles, mais il faut environ un mois pour que toutes les données historiques soient publiées pour une tâche. Ainsi, un mois après avoir planifié une tâche de création de rapports, vous aurez accès à environ sept mois de données. (Toutes les données historiques des emplois créés avant cette annonce doivent être publiées dans le mois qui suit l'annonce.)
Notez que les données historiques ne sont disponibles que depuis le 1er juillet 2015. En conséquence, les emplois créés avant le 28 décembre 2015 auront moins de 180 jours de données historiques.
Ces modifications sont toutes expliquées dans la nouvelle section Données historiques de la présentation de l'API Reporting.
-
La section Caractéristiques du rapport de la présentation de l'API YouTube Reporting a été mise à jour avec les modifications suivantes:
-
La documentation indique désormais que les rapports sont disponibles pendant 180 jours après leur génération, et peuvent donc être téléchargés par les clients API. Auparavant, la documentation indiquait que les rapports étaient disponibles pendant une période allant jusqu'à six mois avant la date d'envoi de la requête API.
-
La documentation a été mise à jour afin de refléter le fait que l'API génère désormais des rapports téléchargeables pour les jours où aucune donnée n'était disponible. Ces rapports contiendront des lignes d'en-tête, mais ne contiendront pas de données supplémentaires.
-
-
L'API YouTube Reporting sera bientôt compatible avec un ensemble de rapports générés automatiquement et gérés par le système, qui contiennent des données sur les revenus publicitaires ou sur les revenus des abonnements à YouTube Red. Ils seront disponibles pour les propriétaires de contenu qui ont déjà accès aux rapports sur les revenus téléchargeables manuellement dans Creator Studio. Ainsi, la nouvelle fonctionnalité d'API fournit un accès programmatique à ces données.
Les modifications suivantes concernant l'API sont annoncées maintenant en vue du lancement des rapports gérés par le système:
-
La nouvelle propriété
systemManaged
de la ressourcejob
indique si la ressource décrit une tâche qui génère des rapports gérés par le système. YouTube génère automatiquement des rapports gérés par le système pour les propriétaires de contenu YouTube. Les propriétaires de contenu ne peuvent pas modifier ni supprimer les tâches qui créent ces rapports. -
Le nouveau paramètre
includeSystemManaged
de la méthodejobs.list
indique si la réponse de l'API doit inclure des tâches pour les rapports gérés par le système. La valeur par défaut de ce paramètre estfalse
. -
Le nouveau paramètre
startTimeAtOrAfter
de la méthodejobs.reports.list
indique que la réponse de l'API ne doit contenir des rapports que si les données les plus anciennes du rapport datent de la date spécifiée ou sont postérieures à celle-ci. De même, le paramètrestartTimeBefore
indique que la réponse de l'API ne doit contenir des rapports que si les données les plus anciennes du rapport sont antérieures à la date spécifiée.Contrairement au paramètre
createdAfter
de la méthode, qui concerne l'heure de création du rapport, les nouveaux paramètres concernent les données du rapport. -
La nouvelle propriété
systemManaged
de la ressourcereportType
indique si la ressource décrit un rapport géré par le système. -
Le nouveau paramètre
includeSystemManaged
de la méthodereportTypes.list
indique si la réponse de l'API doit inclure les rapports gérés par le système. La valeur par défaut de ce paramètre estfalse
.
-
- Dans l'API YouTube Reporting, la dimension
sharing_service
accepte les nouvelles valeurs suivantes :82
: boîte de dialogue de l'activité du système iOS83
: boîte de réception Google84
: Android Messenger
- Dans l'API YouTube Analytics, la dimension
sharingService
accepte les nouvelles valeurs suivantes :ANDROID_MESSENGER
: Android MessengerINBOX
: boîte de réception GoogleIOS_SYSTEM_ACTIVITY_DIALOG
: boîte de dialogue de l'activité du système iOS
- La dimension
playback_location_type
accepte deux nouvelles valeurs :7
: les données concernent les vues enregistrées sur la page d'accueil ou l'écran d'accueil YouTube, dans le flux "Abonnements" de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.8
: les données concernent les vues enregistrées directement sur la page de résultats de recherche YouTube.
- La dimension
traffic_source_type
accepte désormais18
comme valeur de dimension. Cette valeur indique que les vues de la vidéo proviennent d'une page répertoriant l'ensemble des vidéos d'une playlist. Cette source est différente du type de source14
, qui indique que les vues ont eu lieu pendant la lecture de la vidéo dans le cadre d'une playlist. - La dimension
insightPlaybackLocationType
accepte deux nouvelles valeurs :BROWSE
: les données concernent les vues enregistrées sur la page d'accueil ou l'écran d'accueil YouTube, dans le flux "Abonnements" de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.SEARCH
: les données concernent les vues enregistrées directement sur la page de résultats de recherche YouTube.
- La dimension
insightTrafficSourceType
accepte désormaisYT_PLAYLIST_PAGE
comme valeur de dimension. Cette valeur indique que les vues de la vidéo proviennent d'une page répertoriant l'ensemble des vidéos d'une playlist. Cette source est différente du type de sourcePLAYLIST
, qui indique que les vues ont eu lieu pendant la lecture de la vidéo dans le cadre d'une playlist. - Dans l'API YouTube Reporting, la dimension
operating_system
utilise la valeur21
pour identifier les vues enregistrées via Chromecast. - Dans l'API YouTube Analytics, la dimension
operatingSystem
utilise la valeurCHROMECAST
pour identifier les vues enregistrées via Chromecast. -
L'API YouTube Analytics est désormais compatible avec trois nouvelles dimensions sur les détails de lecture, que vous pouvez utiliser dans différents rapports sur les chaînes et les propriétaires de contenu:
liveOrOnDemand
: cette dimension indique si les données du rapport décrivent l'activité de l'utilisateur pendant une diffusion en direct.subscribedStatus
: cette dimension indique si les métriques sur l'activité des utilisateurs présentées dans les données sont associées aux spectateurs qui étaient abonnés à la chaîne de la vidéo ou de la playlist.youtubeProduct
: cette dimension identifie la propriété YouTube sur laquelle l'activité de l'utilisateur a eu lieu. Les valeurs possibles incluent le site Web principal de YouTube (ou l'application YouTube), YouTube Gaming et YouTube Kids.
La documentation a été mise à jour afin d'identifier les nouveaux rapports détaillant les lectures disponibles pour les chaînes et les propriétaires de contenu. En outre, de nombreux autres rapports ont été mis à jour pour indiquer qu'une ou plusieurs de ces dimensions peuvent éventuellement être utilisées en tant que dimensions et/ou filtres dans ces rapports.
-
Le format des tableaux vous expliquant les rapports a été modifié pour vous permettre d'identifier plus facilement les combinaisons valides de dimensions, de métriques et de filtres que vous pouvez utiliser pour récupérer chaque rapport. Le tableau ci-dessous, qui décrit le rapport "Type d'appareil" pour les canaux, présente le nouveau format:
Sommaire Dimensions : Obligatoire deviceType Utilisez 0 ou plus day, liveOrOnDemand, subscribedStatus, youtubeProduct Métriques : Utilisez une ou plusieurs valeurs vues, estimatedMinutesWatched Filtres : Indiquez 0 ou 1 pays, province, continent, subContinent Indiquez 0 ou 1 vidéo, groupe Utilisez 0 ou plus operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct. La terminologie décrivant les champs obligatoires et facultatifs est expliquée dans la documentation relative aux rapports sur les chaînes et sur les propriétaires de contenu.
-
Désormais, l'API YouTube Analytics supprime automatiquement les entités pour lesquelles l'utilisateur de l'API ne peut pas récupérer de données à partir de filtres compatibles avec plusieurs valeurs (
video
,playlist
etchannel
). Auparavant, le serveur d'API renvoyait une erreur si l'utilisateur de l'API ne pouvait pas accéder aux données d'au moins un des éléments spécifiés.Supposons qu'un utilisateur envoie une requête API dans laquelle le filtre
video
répertorie 20 ID vidéo. L'utilisateur est propriétaire de 18 vidéos. Toutefois, un ID vidéo identifie une vidéo appartenant à une autre chaîne, et un autre identifie une vidéo qui a été supprimée et n'existe donc plus. Dans ce cas, au lieu de renvoyer une erreur, le serveur d'API supprime les deux vidéos auxquelles l'utilisateur ne peut pas accéder, et la réponse de l'API contient les données pour les 18 vidéos appartenant à l'utilisateur de l'API. -
Si vous demandez des données pour un
group
YouTube Analytics vide, l'API renvoie désormais un ensemble de données vide plutôt qu'une erreur. -
La méthode
groupItems.insert
de l'API YouTube Analytics renvoie désormais une erreur non autorisée (code de réponse HTTP403
) si vous essayez d'ajouter une entité à un groupe, mais que vous n'y avez pas accès. Auparavant, l'API vous permettait d'ajouter l'entité au groupe, mais a ensuite renvoyé une erreur non autorisée lorsque vous avez essayé de récupérer les données des rapports pour ce groupe. -
La méthode
groups.list
de l'API YouTube Analytics est désormais compatible avec la pagination. Si la réponse de l'API ne contient pas tous les groupes disponibles, le paramètrenextPageToken
de la réponse spécifie un jeton qui peut être utilisé pour récupérer la page de résultats suivante. Définissez le paramètrepageToken
de la méthode sur cette valeur pour récupérer des résultats supplémentaires. -
L'API YouTube Analytics est désormais compatible avec la métrique
redPartnerRevenue
, qui indique le total des revenus estimés générés par les abonnements YouTube Red pour les dimensions de rapport sélectionnées. Cette valeur reflète les revenus générés par les contenus musicaux et non musicaux. Elle est susceptible d'être ajustée en fin de mois.La liste des rapports sur les propriétaires de contenu de l'API YouTube Analytics a été mise à jour afin d'identifier les rapports sur les vidéos compatibles avec la métrique
redPartnerRevenue
:- Statistiques de base
- Basés sur le temps
- Zone géographique de l'utilisateur
- Vidéos les plus regardées : la métrique de tri
redPartnerRevenue
est également disponible dans ce rapport, ce qui signifie que vous pouvez récupérer une liste de vidéos triées en fonction de leurs revenus YouTube Red.
-
La définition du rapport Vidéos les plus regardées pour l'API YouTube Analytics indique désormais que ce rapport est également compatible avec les métriques de revenus suivantes:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
etimpressionBasedCpm
. -
La documentation sur la dimension
date
de l'API YouTube Reporting a été corrigée afin de refléter le fait que les dates font référence à la période de 24 heures commençant à minuit (heure du Pacifique, UTC-8). Auparavant, la documentation indiquait que la date commençait à minuit (GMT).De plus, la documentation de l'API YouTube Analytics a été mise à jour pour indiquer que toutes les dimensions liées aux dates (
day
,7DayTotals
,30DayTotals
etmonth
) font référence à des dates commençant à minuit (heure du Pacifique, UTC-8). -
La méthode
jobs.reports.list()
de l'API YouTube Reporting est désormais compatible avec le paramètre de requêtecreatedAfter
. S'il est spécifié, ce paramètre indique que la réponse de l'API ne doit répertorier que les rapports créés après la date et l'heure spécifiées, y compris les nouveaux rapports contenant des données remplies. Notez que la valeur du paramètre concerne l'heure de création du rapport et non les dates associées aux données renvoyées.La valeur du paramètre est un code temporel au format RFC3339 UTC "Zulu", précis à la microseconde près. Exemple :
"2015-10-02T15:01:23.045678Z"
Les bonnes pratiques concernant l'API YouTube Reporting ont également été mises à jour pour expliquer comment utiliser le paramètre
createdAfter
pour éviter de traiter plusieurs fois le même rapport. -
Les définitions de la propriété
createTime
de la ressourcejob
et les propriétésstartTime
,endTime
etcreateTime
de la ressourcereport
ont toutes été corrigées pour indiquer que les valeurs des propriétés sont précises en microsecondes, et non en nanosecondes. De plus, toutes les définitions indiquent désormais avec précision que la valeur de la propriété est un code temporel. -
La documentation sur la dimension
sharingService
de l'API YouTube Analytics a été mise à jour pour inclure une liste des valeurs possibles. La liste comprend un certain nombre de nouveaux services compatibles.La définition de la dimension
sharing_service
de l'API YouTube Reporting a également été mise à jour afin de lister les nouvelles valeurs acceptées. Les valeurs d'énumération supérieures à59
sont les nouvelles dans la liste. -
La nouvelle API YouTube Reporting permet de récupérer les rapports groupés contenant les données YouTube Analytics d'une chaîne ou d'un propriétaire de contenu. Il est conçu pour les applications qui peuvent importer de grands ensembles de données et qui fournissent des outils permettant de filtrer, trier et exploiter ces données.
Chaque rapport de l'API YouTube Reporting contient un ensemble prédéfini de dimensions et de métriques. (Les rapports de l'API YouTube Analytics utilisent également des métriques et des dimensions.) Dans un rapport, chaque ligne de données présente une combinaison unique de valeurs de dimension. Vous pouvez agréger des données sur plusieurs lignes en fonction des valeurs des dimensions afin de calculer des métriques pour des vidéos, des pays, des vidéos en direct, des abonnés, etc.
Vous pouvez utiliser l'API pour planifier des tâches de création de rapports, chacune d'elles identifiant un rapport que YouTube doit générer. Une fois que vous avez configuré une mission, YouTube génère un rapport quotidien qui peut être téléchargé de manière asynchrone. Chaque rapport contient des données pour une période unique de 24 heures.
-
Bien qu'il s'agisse d'API différentes, les API YouTube Analytics et YouTube Reporting permettent aux développeurs de récupérer les données YouTube Analytics. Étant donné que les deux API permettent d'accéder à des ensembles de données similaires, la documentation des deux API est publiée sous la forme d'un ensemble unique de documents.
- L'onglet Guides de l'ensemble de documentation contient des informations communes aux deux API, y compris des instructions pour autoriser les requêtes API.
- L'onglet Rapports groupés contient une documentation de référence et d'autres contenus spécifiques à l'API YouTube Reporting.
- L'onglet Requêtes ciblées contient une documentation de référence et d'autres contenus spécifiques à l'API YouTube Analytics.
- L'onglet Samples (Exemples de code) liste des exemples de code disponibles pour l'une des deux API.
- L'onglet Tools répertorie les ressources supplémentaires disponibles pour aider les développeurs à implémenter l'une de ces deux API.
-
La documentation de l'API a été restructurée dans une interface pour en faciliter la compréhension. Par conséquent, ces modifications ne décrivent pas les nouvelles fonctionnalités:
-
La documentation contient désormais une page qui liste tous les rapports sur les chaînes et une autre qui listent tous les rapports disponibles pour les propriétaires de contenu. Auparavant, la documentation comportait des pages distinctes pour les rapports sur les vidéos d'une chaîne, les rapports sur les playlists de chaînes, etc.
-
La nouvelle présentation des modèles de données vise à clarifier le fonctionnement de l'API. Plus précisément, nous essayons de mieux expliquer comment YouTube utilise les métriques, les dimensions et les filtres pour calculer les valeurs des rapports.
-
La méthode
reports.query
de l'API, que vous utilisez pour récupérer des rapports, est désormais documentée séparément. Les informations de cette page se trouvaient auparavant sur d'autres pages. Cette nouvelle page est conçue pour vous aider à identifier plus facilement les informations à envoyer pour récupérer un rapport.
-
-
La nouvelle métrique "
adEarnings
" comprend les revenus estimés totaux (revenus nets) de toutes les sources d'annonces vendues par Google. Il ne s'agit pas d'une métrique essentielle. L'API est compatible avec la métriqueadEarnings
pour tous les rapports qui acceptent déjà la métriqueearnings
.En outre, la définition de la métrique "
earnings
" a été corrigée pour tenir compte du fait que sa valeur inclut le total des revenus estimés provenant de toutes les sources publicitaires vendues par Google et non publicitaires. Auparavant, la définition indiquait à tort que la métrique ne comprenait que les revenus provenant de sources publicitaires. -
La métrique
primaryAdGrossRevenue
a été abandonnée. Utilisez plutôt la métriquegrossRevenue
pour récupérer les données sur les revenus. -
En plus de la métrique obsolète
primaryAdGrossRevenue
, les rapports sur les performances des annonces n'acceptent plus les métriquesmonetizedPlaybacks
etplaybackBasedCpm
. Cependant, plusieurs rapports sur les vidéos les acceptent toujours. -
L'API accepte désormais deux nouvelles métriques pour les rapports sur les vidéos :
videosAddedToPlaylists
etvideosRemovedFromPlaylists
. Les listes des rapports sur les vidéos pour les chaînes et les propriétaires de contenu ont été mises à jour afin d'identifier les rapports compatibles avec les nouvelles métriques.videosAddedToPlaylists
: nombre de fois où les vidéos concernées par la requête ont été ajoutées à des playlists YouTube. Les vidéos peuvent avoir été ajoutées à une playlist du propriétaire de la vidéo ou à celles d'autres chaînes.videosRemovedFromPlaylists
: nombre de fois où les vidéos concernées par la requête ont été supprimées de l'ensemble des playlists YouTube. Les vidéos peuvent avoir été supprimées de la playlist du propriétaire de la vidéo ou des playlists d'autres chaînes.
Ces deux métriques incluent des playlists par défaut, comme la playlist "À regarder plus tard". Toutefois, ils ne comptabilisent pas les playlists auxquelles une vidéo est ajoutée automatiquement, comme la playlist de mises en ligne d'une chaîne ou l'historique des vidéos regardées d'un utilisateur. Notez également que ces métriques reflètent le nombre absolu d'ajouts et de suppressions. Ainsi, si un utilisateur ajoute une vidéo à une playlist, la supprime, puis l'ajoute de nouveau, les métriques indiquent que la vidéo a été ajoutée à deux playlists et supprimée d'une playlist.
Les données relatives à ces métriques sont disponibles depuis le 1er octobre 2014.
-
Les métriques
favoritesAdded
etfavoritesRemoved
sont toutes deux obsolètes et entrent en vigueur à compter de cette annonce. Il s'agit à la fois de métriques clés et soumises au règlement relatif aux abandons défini dans les Conditions d'utilisation. -
Le nouveau paramètre
currency
vous permet de récupérer les métriques sur les revenus dans une devise autre que le dollar américain (USD
). S'il est défini, l'API convertit les valeurs des métriquesearnings
,grossRevenue
,playbackBasedCpm
etimpressionBasedCpm
dans la devise spécifiée. Les valeurs affichées sont des estimations calculées à l'aide des taux de change qui changent quotidiennement.La valeur du paramètre est un code de devise ISO 4217 à trois lettres. La valeur par défaut est
USD
. La définition du paramètre contient la liste des codes de devise acceptés. -
L'API permet désormais de créer et de gérer des groupes YouTube Analytics, et de récupérer des données de rapport pour ces groupes.
-
Créer et gérer des groupes
Cette mise à jour présente les ressources
group
etgroupItem
permettant de créer et de gérer des groupes.- La ressource
group
représente un groupe Analytics, une collection personnalisée rassemblant un maximum de 200 chaînes, vidéos, playlists ou éléments. L'API accepte les méthodeslist
,insert
,update
etdelete
pour cette ressource. - La ressource
groupItem
représente un élément d'un groupe Analytics. L'API accepte les méthodeslist
,insert
etdelete
pour cette ressource.
Par exemple, vous pouvez créer un groupe à l'aide de la méthode
groups.insert
, puis y ajouter des éléments à l'aide de la méthodegroupItems.insert
. - La ressource
-
Récupérer les données de rapport pour un groupe
La documentation sur les dimensions a été mise à jour pour inclure la dimension
group
, qui peut servir de filtre dans de nombreux rapports sur les canaux et rapports sur les propriétaires de contenu. Lorsque vous utilisez le filtregroup
, l'API affiche les données de tous les éléments de ce groupe. Notez qu'actuellement, l'API ne permet pas de créer des rapports pour les groupes d'assets.
Consultez le Centre d'aide YouTube pour en savoir plus sur les groupes YouTube Analytics.
-
-
L'API n'accepte plus la dimension
show
. -
L'API permet désormais de spécifier plusieurs valeurs pour les dimensions
video
,playlist
,channel
etshow
lorsque celles-ci sont utilisées comme filtres. Pour spécifier plusieurs valeurs, définissez la valeur du paramètrefilters
sur une liste des ID des vidéos, playlists, chaînes ou émissions pour lesquelles la réponse de l'API doit être filtrée, en les séparant par une virgule. La valeur du paramètre peut spécifier jusqu'à 200 ID.Si vous spécifiez plusieurs valeurs pour le même filtre, vous pouvez également ajouter ce filtre à la liste des dimensions que vous spécifiez pour la demande. Ce principe s'applique même si le filtre n'est pas listé comme dimension acceptée pour un rapport spécifique. Si vous ajoutez le filtre à la liste des dimensions, l'API utilise également les valeurs du filtre pour regrouper les résultats.
Consultez la définition du paramètre
filters
pour en savoir plus sur cette fonctionnalité. -
Lors de la récupération d'un rapport sur les canaux, vous pouvez maintenant récupérer des données sur le canal de l'utilisateur authentifié en définissant la valeur du paramètre
ids
surchannel==MINE
. (Vous pouvez également définir le paramètreids
surchannel==CHANNEL_ID
pour récupérer les données du canal spécifié.) -
L'API est désormais compatible avec les rapports sur les playlists, qui contiennent des statistiques sur les vues de vidéos enregistrées dans le contexte d'une playlist. Les rapports sur les playlists sont disponibles pour les chaînes et les propriétaires de contenu.
Tous les rapports sur les playlists sont compatibles avec les métriques
views
etestimatedMinutesWatched
, et certains acceptent aussi la métriqueaverageViewDuration
.De plus, tous les rapports sur les playlists prennent en charge les nouvelles métriques ci-dessous. Notez que chacune de ces métriques ne tient compte que des vues de playlists enregistrées sur le Web.
playlistStarts
: nombre de fois où des internautes ont lancé la lecture d'une playlist.viewsPerPlaylistStart
: nombre moyen de vues de vidéos à chaque lancement d'une playlist.averageTimeInPlaylist
: estimation de la durée moyenne, en minutes, pendant laquelle un spectateur a regardé des vidéos dans une playlist après le lancement de celle-ci.
Toute demande de récupération d'un rapport sur les playlists doit utiliser le filtre
isCurated
, qui doit être défini sur1
(isCurated==1
). -
L'API propose désormais un rapport sur la rétention d'audience. Ce rapport mesure la capacité d'une vidéo à fidéliser son audience. La nouvelle dimension
elapsedVideoTimeRatio
du rapport mesure la durée écoulée de la vidéo pour les valeurs de métriques correspondantes:-
La métrique
audienceWatchRatio
identifie le nombre absolu de spectateurs qui regardent la vidéo à un moment donné de la vidéo. Ce ratio est calculé en comparant le nombre de fois où une partie d'une vidéo a été visionnée et le nombre total de vues de la vidéo.Sachez qu'une partie d'une vidéo peut être visionnée plusieurs fois (voire aucun) lors d'un même visionnage. Par exemple, si un utilisateur revient en arrière et regarde plusieurs fois la même partie d'une vidéo, le rapport absolu pour cette partie de la vidéo peut être supérieur à
1
. -
La métrique
relativeRetentionPerformance
compare les performances d'une vidéo à la fidélisation des spectateurs lors des lectures par rapport à toutes les vidéos YouTube de durée similaire. La valeur 0 indique que la vidéo retient moins bien les spectateurs que toute autre vidéo de durée similaire, tandis que la valeur 1 indique que la vidéo retient mieux les internautes que toute autre vidéo de durée similaire. Une valeur médiane de 0,5 indique que la moitié des vidéos de durée similaire retiennent mieux les spectateurs tandis que la moitié les fidélise moins.
Vous pouvez également utiliser le filtre
audienceType
pour que le rapport n'affiche que les données associées aux vues naturelles, aux vues provenant d'annonces TrueView InStream ou aux vues provenant d'annonces TrueView InDisplay. Les vues naturelles correspondent directement à une action de l'utilisateur, comme une recherche sur une vidéo ou un clic sur une suggestion de vidéo. -
-
L'API accepte plusieurs nouvelles métriques liées aux annotations. Les métriques listées ci-dessous peuvent être récupérées avec tous les rapports qui acceptaient auparavant les métriques
annotationClickThroughRate
etannotationCloseRate
.annotationImpressions
: nombre total d'impressions d'annotations.annotationClickableImpressions
: nombre d'annotations qui sont apparues et sur lesquelles l'utilisateur peut cliquer.annotationClosableImpressions
: nombre d'annotations qui sont affichées et qui ont pu être fermées.annotationClicks
: nombre total d'annotations sur lesquelles l'utilisateur a cliqué.annotationCloses
: nombre total d'annotations fermées.
Toutes les nouvelles métriques sont des métriques clés et sont soumises au Règlement relatif aux abandons. Notez toutefois que ces données sont disponibles depuis le 16 juillet 2013. Les données pour les métriques
annotationClickThroughRate
etannotationCloseRate
sont disponibles depuis le 10 juin 2012. -
GOOGLE_SEARCH
n'est plus indiqué en tant que valeur distincte pour la dimensioninsightTrafficSourceType
. À la place, les sites référents issus des résultats de recherche Google sont désormais attribués au type de source de trafic "EXT_URL
". Par conséquent, vous ne pouvez plus non plus récupérer un rapportinsightTrafficSourceDetail
qui définit le filtreinsightTrafficSourceType
surGOOGLE_SEARCH
. -
Le document Rapports du propriétaire de contenu a été mis à jour afin de refléter le fait que les métriques
subscribersGained
etsubscribersLost
peuvent désormais être récupérées pour le contenu revendiqué ou importé par un propriétaire de contenu.La modification est visible dans le premier rapport sur les statistiques de base destiné aux propriétaires de contenu, qui est désormais compatible avec les filtres
claimedStatus
etuploaderType
. -
Le document Exemples de demandes a été repensé pour regrouper les exemples par catégories, dans un format d'onglet semblable à celui publié récemment pour les rapports sur les chaînes et les propriétaires de contenu. Dans la nouvelle interface, les exemples sont regroupés dans les catégories suivantes:
- Statistiques de base
- Basés sur le temps
- Ciblage géographique
- Contexte de lecture
- Source de trafic
- Appareil/OS
- Demographic (Catégorie démographique)
- Réseau social
- Revenus/Annonces (uniquement pour les rapports sur les propriétaires de contenu)
-
Le document Exemples de demandes comprend désormais de nouveaux exemples permettant de récupérer des données spécifiques à une province dans les rapports sur les canaux ou dans les rapports sur les propriétaires de contenu.
-
Métriques spécifiques à une province pour les États américains et Washington D.C.: Ce rapport récupère la répartition par province du nombre de vues ainsi que d'autres statistiques sur les vidéos d'une chaîne. Les données couvrent les États américains et l'État de Washington D.C. L'exemple utilise la dimension
province
ainsi que le paramètrefilters
pour que la réponse n'inclue que les résultats pour les États-Unis. -
Données démographiques des spectateurs en Californie (tranche d'âge et genre): ce rapport fournit des statistiques sur la tranche d'âge et le genre des spectateurs en Californie qui ont regardé les vidéos d'une chaîne ou, pour les rapports du propriétaire de contenu, le contenu revendiqué par un propriétaire de contenu. Cet exemple utilise le paramètre
filters
pour garantir que la réponse n'inclut que les données d'une province spécifique.
-
-
La définition de la dimension
province
a été mise à jour pour indiquer que lorsqueprovince
est inclus dans la valeur du paramètredimensions
, la demande doit également limiter les données aux États-Unis en incluantcountry==US
dans la valeur du paramètrefilters
. -
Les documents qui répertorient les rapports sur les chaînes et les propriétaires de contenu compatibles ont été repensés. Au lieu de fournir un tableau listant tous les rapports possibles, chaque document regroupe les rapports en catégories:
- Statistiques de base
- Basés sur le temps
- Ciblage géographique
- Contexte de lecture
- Source de trafic
- Appareil/OS
- Demographic (Catégorie démographique)
- Réseau social
- Vidéos les plus regardées
Dans chaque document, ces catégories s'affichent sous la forme d'une liste d'onglets. Vous pouvez cliquer sur n'importe quel onglet pour afficher les rapports compatibles qui y sont associés.
-
L'API accepte désormais trois nouvelles dimensions géographiques:
province
,continent
etsubContinent
.-
La dimension
province
vous permet de récupérer des statistiques pour les États américains et pour le district de Colombie. L'API permet d'utiliser cette dimension de deux façons:-
L'API prend en charge deux rapports qui détaillent les statistiques par état. Ces deux rapports sont disponibles pour les chaînes et les propriétaires de contenu.
- Le rapport sur les statistiques clés comprend plusieurs statistiques, y compris le nombre de vues et l'estimation du nombre de minutes regardées.
- Le rapport basé sur l'heure fournit les mêmes statistiques, mais regroupe les données sur une base quotidienne, 7 jours, 30 jours ou mensuelle.
-
Vous pouvez utiliser le paramètre de requête
filters
pour limiter un rapport aux statistiques d'un état particulier. Plusieurs rapports sont compatibles avec ce type de filtrage, y compris les rapports sur les zones géographiques, les rapports sur les contextes de lecture, les rapports sur les sources de trafic, les rapports sur les appareils, les rapports sur les systèmes d'exploitation, les rapports sur les performances démographiques et les rapports sur les vidéos les plus populaires.
-
-
La dimension
continent
spécifie un code de région statistique des Nations Unies (UN) identifiant un continent. Cette dimension ne peut être utilisée qu'en tant que filtre. -
La dimension
subContinent
spécifie un code de région statistique des Nations Unies (ONU) qui identifie une sous-région d'un continent. Cette dimension ne peut être utilisée qu'en tant que filtre.Étant donné que chaque sous-région n'est associée qu'à un seul continent, il n'est pas nécessaire d'utiliser également le filtre
continent
lorsque vous utilisez le filtresubContinent
. En fait, l'API renverra une erreur si une requête utilise les deux dimensions.
-
-
La documentation a été corrigée afin que la dimension
insightTrafficSourceDetail
n'inclue pas la valeurinsightTrafficSourceType
PROMOTED
comme valeur de filtre valide. -
L'API YouTube Analytics est désormais soumise au règlement relatif aux abandons décrit dans les Conditions d'utilisation. Toutefois, les dimensions et métriques secondaires de l'API ne sont pas soumises au règlement relatif aux abandons. Les pages Dimensions et metrics ont été mises à jour pour lister les dimensions principales et les métriques principales. De plus, les définitions figurant sur ces pages ont été mises à jour afin d'identifier explicitement les dimensions et métriques principales.
-
L'API accepte désormais
EXTERNAL_APP
en tant que valeur pour la dimensioninsightPlaybackLocationType
. Parallèlement à cette mise à jour, les lectures ne sont plus classées dans la catégorieMOBILE
depuis le 10 septembre 2013, mais les lectures effectuées sur mobile avant cette date le seront toujours.Avec cette mise à jour, les lectures sur mobile sont désormais classées dans les catégories
WATCH
,EMBEDDED
ouEXTERNAL_APP
, en fonction du type d'application où elles ont lieu. -
L'API accepte désormais
PLAYLIST
en tant que valeur pour la dimensioninsightTrafficSourceType
. La valeur indique que les vues de la vidéo proviennent d'une playlist. Auparavant, ces vues étaient classées dans la catégorieYT_OTHER_PAGE
de la dimension. -
L'API permet désormais de trier les rapports selon plusieurs dimensions et métriques. L'exemple de document de demande comprend un nouvel exemple, Trier les demandes selon plusieurs dimensions/métriques, qui illustre cette fonctionnalité. La requête récupère les données sur les sources de trafic, et la valeur du paramètre
sort
estday,-views
. Les résultats sont triés par ordre chronologique, mais dans l'ensemble de résultats pour chaque jour, la première ligne contient les données sur la source de trafic ayant généré le plus de vues, la deuxième ligne les données pour la source ayant généré le plus grand nombre de vues, et ainsi de suite. -
L'API est désormais compatible avec deux nouvelles dimensions,
deviceType
etoperatingSystem
, qui permettent de récupérer des données sur les appareils sur lesquels les spectateurs regardent vos vidéos. L'API est compatible avec les rapports qui utilisent l'une ou les deux dimensions.-
Le rapport
deviceType
vous permet de connaître le nombre de vues et la durée de visionnage estimée pour différents types d'appareils, y compris les ordinateurs, les mobiles et les tablettes. Vous pouvez également utiliser le filtreoperatingSystem
pour que le rapport sur le type d'appareil ne contienne que les statistiques des appareils exécutant un système d'exploitation spécifique, tel que Android ou iOS. -
Le rapport
operatingSystem
vous permet de récupérer le nombre de vues et la durée de visionnage estimée pour différents systèmes d'exploitation, comme Android, iOS, Linux, etc. Vous pouvez également utiliser le filtredeviceType
pour que le rapport sur le système d'exploitation ne contienne que les statistiques pour un type d'appareil spécifique, comme les appareils mobiles ou les tablettes.
De nouveaux rapports sur le type d'appareil et le système d'exploitation sont disponibles pour les chaînes et les propriétaires de contenu.
-
-
Le document sur les exemples de demandes a été mis à jour pour inclure trois rapports sur les appareils pour les chaînes et trois rapports sur les appareils pour les propriétaires de contenu.
-
La dimension
insightPlaybackLocationType
peut renvoyer la valeurYT_OTHER
, qui identifie les vues qui ne sont pas classées à l'aide de l'une des autres valeurs de la dimension. -
Le document Rapports sur les propriétaires de contenu a été mis à jour pour indiquer que vous pouvez trier le rapport sur les vidéos les plus performantes par ordre décroissant des revenus afin d'identifier les vidéos les plus rémunératrices. Ce rapport est le premier à figurer dans le deuxième tableau de la section Rapports sur l'activité des utilisateurs et sur les revenus.
-
YouTube n'identifie plus les fonctionnalités ni les services expérimentaux d'une API. À la place, nous fournissons désormais une liste des API YouTube soumises au règlement relatif aux abandons.
-
L'API permet désormais de récupérer les métriques sur la durée de visionnage (
estimatedMinutesWatched
,averageViewDuration
etaverageViewPercentage
) en plus d'autres métriques, comme les métriques sur les vues, l'engagement, les revenus et les performances des annonces.Les listes des rapports sur les chaînes et des rapports sur les propriétaires de contenu disponibles ont été mises à jour pour refléter ce changement. Les listes sont désormais plus courtes, car les métriques sur la durée de visionnage peuvent être récupérées depuis d'autres rapports répertoriés.
Le document Exemples de requêtes API a également été mis à jour.
-
Les rapports qui utilisent les dimensions
insightPlaybackLocationDetail
etinsightTrafficSourceDetail
ont été améliorés comme suit:-
Elles sont désormais compatibles avec un filtre
country
facultatif. -
Les propriétaires de contenu peuvent désormais récupérer ces rapports à l'aide des nouvelles combinaisons
filter
suivantes. Notez que toutes ces combinaisons sont également compatibles avec le filtrecountry
facultatif.-
Détails sur le contexte de lecture
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Informations sur la source de trafic
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
Le nouveau document Exemples de requêtes API fournit des exemples qui montrent comment récupérer de nombreux types de rapports différents à l'aide de YouTube Analytics API. Chaque exemple inclut une brève description du rapport récupéré par la demande, puis affiche les dimensions, les métriques, les filtres et les paramètres de tri de la demande.
-
La dimension
insightTrafficSourceType
accepte désormaisSUBSCRIBER
comme valeur valide. Cette valeur identifie les vues de vidéos provenant des flux de la page d'accueil YouTube ou des fonctionnalités d'abonnement YouTube. Si vous filtrez en fonction de cette source de trafic, le champinsightTrafficSourceDetail
indiquera le flux de la page d'accueil ou une autre page à partir de laquelle les vues proviennent des vues. -
L'API accepte désormais deux nouvelles métriques,
annotationClickThroughRate
etannotationCloseRate
, qui sont liées aux interactions des spectateurs avec les annotations qui s'affichent pendant vos vidéos. Les listes des rapports sur les chaînes et des rapports sur les propriétaires de contenu ont toutes deux été mises à jour afin d'identifier les rapports compatibles avec les nouvelles métriques.annotationClickThroughRate
: ratio entre les annotations sur lesquelles les internautes ont cliqué et le nombre total d'impressions d'annotations cliquables.annotationCloseRate
: ratio entre le nombre d'annotations que les spectateurs ont fermées et le nombre total d'impressions d'annotations.
-
L'API est désormais compatible avec les métriques sur les revenus et les performances des annonces, ainsi que de nouveaux rapports sur les performances des annonces. Seuls les partenaires de contenu YouTube qui participent au Programme Partenaire YouTube ont accès aux métriques et aux rapports.
-
Les nouveaux rapports sont compatibles avec les métriques de performances des annonces basées sur les lectures et celles basées sur les impressions. Pour en savoir plus sur les rapports sur les performances des annonces, consultez la documentation concernant les rapports du propriétaire de contenu.
-
Les nouvelles métriques prises en charge sont listées ci-dessous. La liste des rapports du propriétaire de contenu a été mise à jour afin d'identifier les rapports, y compris les deux nouveaux rapports, qui acceptent ces métriques.
earnings
: total des revenus estimés de toutes les sources d'annonces vendues par Google.grossRevenue
: revenus bruts estimés provenant de Google ou des partenaires DoubleClickprimaryAdGrossRevenue
: revenus bruts estimés, cumulés et classés sous le type d'annonce principal pour les lectures de vidéos couvertes par le rapport, provenant de Google ou de partenaires DoubleClick.monetizedPlaybacks
: nombre de lectures ayant généré au moins une impression d'annonce.playbackBasedCpm
: revenus bruts estimés pour mille lectures.impressions
: nombre d'impressions d'annonces validées diffusées.impressionBasedCpm
: revenus bruts estimés pour mille impressions d'annonces
Remarque:Pour en savoir plus, consultez les définitions des métriques.
-
Toute demande qui récupère des métriques sur les revenus ou les performances des annonces doit envoyer un jeton d'autorisation qui accorde l'accès à l'aide du nouveau champ d'application
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
.
-
-
La documentation sur l'API a été réorganisée afin que les différents types de rapports soient expliqués sur des pages distinctes. Par conséquent, les différents types de rapports sur les chaînes et de rapports sur les propriétaires de contenu sont désormais présentés séparément.
-
Le guide de référence de l'API contient désormais une section Exemples, qui inclut des exemples de code qui montrent comment appeler l'API à l'aide des bibliothèques clientes Java, JavaScript, Python et Ruby. L'exemple de code JavaScript est le même que celui décrit en détail dans la documentation de l'exemple d'application.
-
Le guide de référence de l'API inclut à présent APIs Explorer, qui vous permet d'appeler l'API, de consulter la requête API et de récupérer des données réelles dans la réponse.
-
L'API est compatible avec un certain nombre de nouveaux rapports décrits ci-dessous, destinés aux chaînes et aux propriétaires de contenu. Chaque rapport se présente sous la forme d'un rapport sur les chaînes ou d'un rapport sur les propriétaires de contenu. Les pages Dimensions et metrics ont également été mises à jour en conséquence.
-
Le rapport sur les contextes de lecture indique le nombre de vues de vidéos sur différents types de pages ou d'applications.
-
Le rapport détaillé sur le contexte de lecture identifie les lecteurs intégrés ayant généré le plus de vues pour une vidéo spécifique. Il fournit un affichage plus détaillé que le rapport sur les contextes de lecture, car il identifie les URL associées aux principaux lecteurs intégrés.
-
Le rapport sur les sources de trafic identifie le nombre de vues de vidéos générées par différents types d'URL de provenance.
-
Le rapport détaillé sur les sources de trafic identifie les URL de provenance ayant généré le plus de vues pour une vidéo donnée et pour un type de source de trafic donné. Par exemple, ce rapport peut vous présenter les vidéos similaires qui ont généré le plus de trafic vers une vidéo spécifique. Ce rapport est compatible avec plusieurs sources de trafic.
-
Les rapports sur la durée de visionnage indiquent le temps que les spectateurs ont passé à regarder vos contenus. Les rapports peuvent regrouper les données d'une période spécifique (jour, sept jours précédents, 30 jours précédents, etc.) ou un pays. Si un rapport regroupe les données par jour ou par pays, il peut également spécifier la durée moyenne de chaque visionnage, ainsi que le pourcentage moyen de chaque vidéo visionnée par les internautes.
-
-
YouTube Analytics API est désormais disponible pour tous les développeurs. Vous pouvez activer l'API pour votre projet sans avoir à demander au préalable l'accès depuis le panneau Services dans le APIs console.
-
La nouvelle section Premiers pas décrit les conditions préalables et la procédure de base pour créer une application qui utilise YouTube Analytics API.
-
La nouvelle section Comprendre l'utilisation des quotas fournit des conseils pour optimiser votre utilisation des quotas d'API. Le serveur d'API calcule le coût de chaque requête. Ce coût est déduit de votre quota d'utilisation de l'API. Étant donné que les différents types de rapports peuvent générer des coûts de requête très différents, vous devez prévoir d'utiliser votre quota efficacement et votre application ne doit demander que les métriques et les données dont elle a réellement besoin.
-
La section Dimensions temporelles a été mise à jour pour expliquer que ces dimensions indiquent qu'un rapport Analytics doit regrouper les données en fonction d'une période donnée. L'API prend désormais en charge les dimensions temporelles supplémentaires suivantes:
7DayTotals
: les données du rapport seront agrégées afin que chaque ligne contienne les données sur une période de sept jours.30DayTotals
: les données du rapport seront agrégées pour que chaque ligne contienne les données correspondant à une période de 30 jours.month
: les données du rapport sont agrégées par mois calendaire.
De même, la section Rapports disponibles a été mise à jour pour refléter la compatibilité de l'API avec les rapports utilisant ces dimensions.
-
La section Dimensions des entités de rapport a été mise à jour pour indiquer que les requêtes API visant à récupérer les rapports des propriétaires de contenu doivent filtrer les données à l'aide de l'une de ces dimensions (
video
,channel
oushow
) ou d'une combinaison compatible des dimensionsclaimedStatus
etuploaderType
. -
L'API accepte désormais deux nouvelles options de tri pour les rapports sur les vidéos les plus regardées. Ces rapports, qui sont disponibles sous la forme de rapports sur les chaînes ou de propriétaires de contenu, affichent des métriques (vues, commentaires, "J'aime", etc.) par pays et réparties par vidéo. Vous pouvez désormais trier ces rapports en fonction du nombre d'utilisateurs qui se sont abonnés à une chaîne ou se sont désabonnés à partir de la page de lecture de la vidéo.
-
Les définitions des metrics
subscribersGained
etsubscribersLost
ont été modifiées pour expliquer qu'une chaîne peut gagner ou perdre des abonnés à plusieurs endroits, y compris sur la page de lecture de la vidéo, sur la page de la chaîne et dans le guide qui s'affiche sur la page d'accueil YouTube. Lorsque ces métriques apparaissent dans un rapport spécifique à une vidéo, elles incluent uniquement celles issues de la page de lecture de la vidéo en question.
L'API YouTube Reporting est compatible avec trois nouveaux rapports sur les écrans de fin, ainsi que de nouvelles dimensions et métriques pour ces rapports. Les rapports fournissent des statistiques sur les impressions et les clics pour les écrans de fin qui s'affichent après l'arrêt de la lecture d'une vidéo.
Consultez le centre d'aide YouTube pour savoir comment ajouter des écrans de fin à vos vidéos.
8 novembre 2016
Cette mise à jour contient les modifications suivantes apportées à l'API YouTube Analytics:
27 octobre 2016
YouTube génère désormais automatiquement un ensemble de rapports sur les revenus publicitaires gérés par le système pour les propriétaires de contenu qui ont accès aux rapports correspondants dans la section Rapports de YouTube Studio. Les nouveaux rapports des API gérées par le système sont conçus pour fournir un accès programmatique aux données également disponibles dans les rapports Creator Studio téléchargeables manuellement.
La présentation des rapports gérés par le système offre une brève présentation des nouveaux rapports et explique le processus permettant de les récupérer via l'API. Ce processus est légèrement différent de celui utilisé pour récupérer des rapports groupés pour YouTube Analytics, car les partenaires n'ont pas besoin de planifier des tâches pour générer les rapports.
La propriété id
de la ressource reportType
a été mise à jour pour inclure la liste des rapports gérés par le système auxquels vous pouvez accéder via l'API:
27 septembre 2016
Remarque:Il s'agit d'une annonce d'abandon.
La métrique uniques
de l'API YouTube Analytics a été abandonnée. Cette métrique n'est pas essentielle et sera disponible jusqu'au 31 octobre 2016.
15 septembre 2016
Cette mise à jour inclut les modifications suivantes de l'API YouTube Reporting:
19 août 2016
Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Reporting:
11 août 2016
Cette mise à jour inclut les changements suivants :
10 août 2016
Cette mise à jour inclut les modifications suivantes:
18 juillet 2016
Cette mise à jour inclut les modifications suivantes:
28 juin 2016
La documentation de l'API YouTube Analytics a été mise à jour afin de prendre en compte les métriques sur les fiches dans de nombreux rapports sur les chaînes et les propriétaires de contenu. Voici les nouvelles métriques prises en charge:
Les métriques sont compatibles avec les types de rapports suivants:
22 juin 2016
Cette mise à jour inclut les modifications suivantes de l'API YouTube Reporting. La première modification concerne l'API en général. Les autres modifications ne concernent que les rapports pour les propriétaires de contenu:
19 mai 2016
Cette mise à jour inclut les modifications suivantes de l'API YouTube Reporting:
12 avril 2016
Cette mise à jour inclut les modifications suivantes, qui ne concernent que l'API YouTube Reporting:
28 mars 2016
Les API YouTube Reporting et YouTube Analytics affichent désormais des statistiques sur les vues pour plusieurs services de partage supplémentaires.
16 mars 2016
Cette mise à jour inclut les modifications suivantes, qui affectent à la fois l'API YouTube Reporting et l'API YouTube Analytics:
API YouTube Reporting
API YouTube Analytics
8 février 2016
La liste des métriques compatibles avec l'API YouTube Analytics a été mise à jour de sorte que les métriques de fiche ne figurent plus parmi les métriques compatibles avec cette API. (Aucun des rapports de cette API n'avait été documenté comme prenant en charge les métriques des fiches.)
Sachez que vous pouvez toujours récupérer les métriques sur les fiches à l'aide de l'API YouTube Reporting, qui est compatible avec de nombreux rapports sur les chaînes et les propriétaires de contenu.
6 janvier 2016
Les API YouTube Reporting et YouTube Analytics identifient désormais spécifiquement les vues générées via un appareil Chromecast.
21 décembre 2015
Dans la documentation, les noms des métriques annotation_clickable_impressions
et annotation_closable_impressions
ont été mis à jour pour correspondre aux noms renvoyés dans les rapports. Auparavant, ces noms étaient enregistrés sous la forme clickable_annotation_impressions
et closable_annotation_impressions
.
18 décembre 2015
La législation de l'Union européenne (UE) exige que les utilisateurs finaux de l'UE doivent divulguer certaines informations et obtenir leur consentement. Par conséquent, pour les utilisateurs finaux de l'Union européenne, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE. Nous avons ajouté une notification à ce sujet dans les Conditions d'utilisation de l'API YouTube.
15 décembre 2015
Cette mise à jour inclut les modifications suivantes, qui affectent toutes l'API YouTube Analytics:
10 novembre 2015
Cette mise à jour inclut les changements suivants :
29 octobre 2015
Cette mise à jour inclut les changements suivants :
8 octobre 2015
Cette mise à jour inclut les changements suivants :
24 septembre 2015
Cette mise à jour inclut les changements suivants :
20 août 2015
Cette mise à jour inclut les changements suivants :
22 juillet 2015
Cette mise à jour comporte plusieurs modifications, qui ne concernent toutes que les propriétaires de contenu:
1er juin 2015
Cette mise à jour inclut les changements suivants :
31 mars 2015
Cette mise à jour inclut les changements suivants :
16 mars 2015
Cette mise à jour inclut les changements suivants :
25 février 2015
Cette mise à jour inclut les changements suivants :
13 février 2015
Cette mise à jour inclut les changements suivants :
28 août 2014
Cette mise à jour inclut les changements suivants :
16 juillet 2014
Cette mise à jour inclut les changements suivants :
31 janvier 2014
Cette mise à jour inclut les changements suivants :
16 janvier 2014
Cette mise à jour inclut les changements suivants :
6 janvier 2014
Cette mise à jour inclut les changements suivants :
30 septembre 2013
Cette mise à jour inclut les changements suivants :
16 juillet 2013
Cette mise à jour inclut les changements suivants :
23 mai 2013
Cette mise à jour inclut les changements suivants :
10 mai 2013
Cette mise à jour inclut les changements suivants :
6 mai 2013
Cette mise à jour inclut les changements suivants :
3 mai 2013
Cette mise à jour inclut les changements suivants :
28 mars 2013
Cette mise à jour inclut les changements suivants :
21 mars 2013
Cette mise à jour inclut les changements suivants :
4 février 2013
Cette mise à jour inclut les changements suivants :
14 novembre 2012
Cette mise à jour inclut les changements suivants :
2 octobre 2012
Cette mise à jour inclut les changements suivants :
12 septembre 2012
Cette mise à jour inclut les changements suivants :