Historique des révisions

Cette page répertorie les modifications apportées à l'API et à la documentation de YouTube Reporting et de YouTube Analytics. Les deux API permettent aux développeurs d'accéder aux données YouTube Analytics, mais de différentes manières. S'abonner à ce journal des modifications S'abonner

15 décembre 2022

L'API YouTube Analytics (ciblage ciblé) accepte deux nouvelles variables 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 l'estimation de YouTube concernant la ville où l'activité de l'utilisateur a eu lieu.

  • La nouvelle dimension creatorContentType identifie le type de contenu YouTube associé aux métriques d'activité des utilisateurs dans la ligne de données. Les valeurs acceptées sont LIVE_STREAM, SHORTS, STORY et VIDEO_ON_DEMAND.

    La dimension creatorContentType est disponible comme dimension facultative pour tous les rapports sur les vidéos et les propriétaires de contenu.

  • Le guide sur les 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 et 30DayTotals ont été supprimées de la documentation. L'abandon de ces dimensions a été annoncé en octobre 2019.

26 août 2022

L'API YouTube Analytics (requêtes ciblées) et l'API de création de rapports YouTube (rapports groupés) acceptent une nouvelle valeur détaillée pour la source de trafic:

  • Dans l'API YouTube Analytics (requêtes ciblées), si la valeur de la dimension insightTrafficSourceType est SUBSCRIBER, la valeur insightTrafficSourceDetail peut être définie sur podcasts, ce qui indique que le trafic provient de la page de destination Podcasts.
  • Dans l'API de création de rapports groupés YouTube, si la valeur de la dimension traffic_source_type est 3, la valeur traffic_source_detail peut être définie sur podcasts, ce qui indique que le trafic provient de la page de destination Podcasts.

11 février 2022

L'ensemble de valeurs valides pour la dimension gender sera modifié à compter du 11 août 2022. Il peut s'agir d'une modification incompatible avec les versions antérieures de votre implémentation de l'API. Conformément à la section Modifications incompatibles des conditions d'utilisation des services d'API YouTube, nous annonçons ce changement six mois avant son entrée en vigueur. Veuillez mettre à jour votre implémentation de l'API avant le 11 août 2022 pour faciliter la transition vers le nouvel ensemble de valeurs.

Les modifications spécifiques apportées sont les suivantes:

  • Dans l'API (requêtes ciblées) YouTube Analytics, la dimension gender accepte actuellement deux valeurs: female et male. À partir du 11 août 2022, cette dimension acceptera trois valeurs: female, male et user_specified.
  • Dans l'API de création de rapports groupés YouTube, la dimension gender accepte actuellement trois valeurs : FEMALE, MALE et GENDER_OTHER. À partir du 11 août 2022, l'ensemble de valeurs acceptées sera FEMALE, MALE et USER_SPECIFIED.

9 février 2022

Deux métriques ont été mises à jour pour exclure le trafic de boucles en boucle à compter du 13 décembre 2021. Ce changement concerne à la fois l'API YouTube Analytics (requêtes ciblées) et l'API YouTube Reporting (rapports groupés).

2 février 2022

Cette 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 de création de rapports groupés YouTube, la dimension traffic_source_type accepte la valeur 28.

Pour ce type de source de trafic, la dimension traffic_source_detail spécifie l'ID de la chaîne à partir duquel l'utilisateur a été redirigé.

23 septembre 2020

Cette API YouTube Analytics (requêtes ciblées) et l'API de création de rapports YouTube (rapports groupés) acceptent une nouvelle valeur de dimension "Source de trafic" qui indique que l'utilisateur a été orienté verticalement en balayant l'écran dans l'interface de visionnage YouTube Shorts:

  • Dans l'API YouTube Analytics (requêtes ciblées), la dimension insightTrafficSourceType accepte la valeur SHORTS.
  • Dans l'API de création de rapports groupés YouTube, la dimension traffic_source_type accepte la valeur 24.

La dimension "Informations détaillées sur 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 concernent l'API YouTube Analytics (ciblage ciblé) :

  • 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éthode reports.query permet d'identifier 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 filtres video, playlist et channel. De plus, 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 inclut les modifications suivantes concernant l'API YouTube Analytics (requêtes ciblées) et l'API de création de rapports YouTube (rapports groupés). Pour en savoir plus sur ces modifications, consultez le Centre d'aide YouTube.

Dans les deux API, l'ensemble des valeurs de détails des sources de trafic possibles pour les notifications change. Dans les requêtes ciblées, les notifications sont signalées par la valeur insightTrafficSourceType=NOTIFICATION. Dans les rapports groupés, les notifications sont indiquées sous la forme traffic_source_type=17.

Les nouvelles valeurs divisent les notifications concernant les vidéos mises en ligne et les diffusions en direct, auparavant signalées par la mention uploaded, dans deux catégories:

  • uploaded_push : nombre de vues provenant des notifications push envoyées aux abonnés lors de la mise en ligne d'une vidéo
  • uploaded_other : le nombre de vues est généré par des notifications non push, telles que des notifications par e-mail ou dans Inbox, qui sont envoyées aux abonnés lors de la mise en ligne d'une vidéo.

Ces valeurs sont renvoyées pour la période à partir du 13 janvier 2020 (13 janvier 2020).

Pour rappel, ces valeurs ne représentent pas les notifications elles-mêmes, mais les sources de trafic qui ont 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, la ligne indique que trois vues ont été générées par des spectateurs qui ont cliqué sur les 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 YouTube Analytics (ciblage ciblé) :

  • Remarque : Il s'agit d'une annonce d'abandon.

    Les dimensions 7DayTotals et 30DayTotals ne seront plus acceptées sur YouTube. Vous pouvez toujours récupérer des données à l'aide de ces dimensions jusqu'au 15 avril 2020. À compter de cette date, toute tentative de récupération de rapports à l'aide de la dimension 7DayTotals ou 30DayTotals renverra une erreur.

    Notez que les utilisateurs peuvent reproduire certaines des données pour ces dimensions en interrogeant à l'aide de la dimension day et en agrégeant ou en déduisant des données sur des périodes de sept ou 30 jours. Exemple :

    • Le nombre de vues pour une période de sept jours peut être calculé en cumulant le nombre de vues pour chaque jour de cette période.
    • Le pourcentage de spectateurs sur une période de sept jours peut être calculé en multipliant le nombre de vues enregistrées chaque jour par le pourcentage de spectateurs du jour afin d'obtenir le nombre de spectateurs connectés. 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.
    • Le nombre de spectateurs uniques sur une période de sept jours ne peut pas être calculé, car le même spectateur peut être calculé comme un spectateur unique sur différents jours. Toutefois, vous pouvez utiliser la dimension month au lieu de la dimension 30DayTotals pour extrapoler les données sur le nombre de spectateurs uniques sur une période de 30 jours. Notez que la dimension month fait référence aux mois calendaires, tandis que la dimension 30DayTotals 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 YouTube Analytics (ciblage ciblé) :

  • La version 1 de l'API étant désormais totalement 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 YouTube Analytics (ciblage ciblé) :

  • 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 pour qu'ils utilisent la version 2 dès que possible afin de minimiser les interruptions de service. Pour en savoir plus, consultez le guide de migration.

    Notez que le calendrier de cet abandon avait été initialement annoncé le 26 avril 2018.

17 septembre 2018

Cette mise à jour inclut les modifications suivantes liées à l'API YouTube Analytics (ciblage ciblé) :

  • La nouvelle section sur l'anonymisation des données du document de 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 ne contient pas tout ou partie de vos données si:

    1. Le trafic d'une vidéo ou d'une chaîne sur une période donnée est limité.

      ou

    2. vous avez sélectionné un filtre ou une dimension, telle que la source de trafic ou le pays, pour lequel les valeurs n'atteignent pas un certain seuil.

    Elle aborde également les types de données pouvant être limités 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 refléter le fait que les métriques redViews et estimatedRedMinutesWatched ne sont plus disponibles pour 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:

  • Les exigences relatives au champ d'application pour les méthodes suivantes ont changé :
    • Les requêtes adressées à la méthode reports.query doivent avoir accès au champ d'application https://www.googleapis.com/auth/youtube.readonly.
    • Les requêtes adressé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'application https://www.googleapis.com/auth/yt-analytics.readonly

      La première option utilise un champ d'application en lecture/écriture, tandis que la seconde utilise deux champs d'application en lecture seule.

23 mai 2018

Cette mise à jour inclut les modifications suivantes:

  • La présentation de l'API contient une nouvelle section, agréger les métriques et les éléments supprimés, qui explique comment les réponses de l'API gèrent 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 Conditions d'utilisation des services d'API YouTube (sections III.E.4.b à III.E.4.d), les clients API doivent soit supprimer, soit actualiser les métadonnées de ressources stockées à partir de cette API au bout de 30 jours.

22 mai 2018

Cette mise à jour inclut les modifications suivantes concernant l'API de création de rapports YouTube (rapports groupés) :

  • Les modifications suivantes doivent entrer en vigueur en juillet 2018, et 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 les rapports sur les annonces de remplissage, seront disponibles pendant 60 jours à compter de leur génération. Toutefois, les rapports contenant les données de l'historique sont disponibles pendant 30 jours à compter de leur génération.

      Avant cette annonce, tous les rapports d'API étaient disponibles pendant 180 jours à compter de leur génération. Pour rappel, lorsque cette modification entrera en vigueur, les rapports de données historiques datant de plus de 30 jours ne seront plus accessibles via l'API. Les autres rapports datant de plus de 60 jours ne seront plus accessibles. À ce titre, la documentation indique désormais que les rapports créés avant la modification du règlement seront disponibles jusqu'à 180 jours.

    • Après la modification, lorsque vous planifiez une tâche de reporting, YouTube génère des rapports à partir de ce jour et couvrant la période de 30 jours précédant la planification de la tâche. Avant la modification, lorsque vous planifiez une tâche de reporting, YouTube génère des rapports couvrant la période de 180 jours précédant la planification de la tâche.

  • 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 Conditions d'utilisation des services d'API YouTube (sections III.E.4.b à III.E.4.d), les clients API doivent soit supprimer, soit actualiser les métadonnées de ressources stockées à partir de cette API au bout de 30 jours.

  • La section Caractéristiques du rapport a été mise à jour de façon à indiquer que, même si les données des rapports ne sont pas filtrées, les rapports contenant des données portant sur une période postérieure au 1er juin 2018 ne contiendront aucune référence à des ressources YouTube supprimées au moins 30 jours avant la date à laquelle le rapport a été généré.

  • La section Historique de la vue d'ensemble 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 en quelques jours. Auparavant, la documentation indiquait que la mise à disposition de ces rapports pouvait prendre jusqu'à 30 jours.

  • 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 en tant qu'ensemble de données qui remplace un ensemble déjà diffusé.

26 avril 2018

La version 2 de l'API YouTube Analytics (Targeted ciblées) (v2) est désormais disponible publiquement. La liste suivante identifie les modifications de produit et de documentation liées à la nouvelle version de l'API:

  • La version 2 de l'API est presque identique à la version 1. Toutefois, vous devrez probablement mettre à jour votre code pour refléter les modifications répertoriées ci-dessous. Tous ces changements sont expliqués en détail dans le nouveau guide de migration.

    • La version de l'API est passée de v1 à v2.
    • L'URL de base pour les 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 changé de nom. Plus précisément, les noms de paramètres contenant des traits d'union, tels que end-date dans l'API v1, utilisent une casse de chameau (endDate) plutôt que des traits d'union dans l'API v2. Cette modification rend les noms de paramètres cohérents dans l'API, car les méthodes de l'API pour la création et la gestion des groupes utilisaient déjà la casse en chameau pour les noms de paramètres.
    • La version 2 de l'API n'est pas compatible avec les requêtes par lot envoyées au point de terminaison HTTP global de Google (www.googleapis.com/batch). Si vous envoyez des requêtes par lot dans la version 2, vous devez utiliser le point de terminaison https://youtubeanalytics.googleapis.com/v2 à la place.

    En outre, certaines fonctionnalités de la version v1 ne sont pas compatibles avec l'API v2:

    • La méthode reports.query n'accepte plus les paramètres de requête alt, quotaUser et userIp.
    • La version 2 de l'API ne fournit pas de point de terminaison de traitement par lot compatible avec les lots composés de requêtes adressées à différentes API. (Un lot peut toutefois être composé de requêtes envoyé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 requêtes par lot dans toutes ses API.
    • La version 2 de l'API n'est pas compatible avec le protocole JSON-RPC, qui était compatible avec l'API v1. Encore une fois, cet abandon n'est pas spécifique à l'API YouTube Analytics.

  • Remarque : Il s'agit d'une annonce d'abandon.

    La version 1 de l'API (v1) est désormais obsolète et sera disponible jusqu'au 31 octobre 2018. Toutes les requêtes adressées à l'API v1 cesseront de fonctionner après cette date. Veillez donc à passer à la version 2 de l'API au plus tard le 31 octobre 2018, afin d'é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:

  • Les rapports sur les performances démographiques des spectateurs, qui regroupent les statistiques de visionnage en fonction de la tranche d'âge et du sexe des utilisateurs, ne sont plus compatibles avec la dimension youtubeProduct, qui identifie le service YouTube sur lequel l'activité de l'utilisateur a été enregistrée.

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
  • API YouTube Analytics (requêtes ciblées)

20 décembre 2017

Cette mise à jour inclut deux modifications liées à l'API YouTube Reporting:

  • Le serveur d'API est désormais 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 nécessaire pour chaque réponse de l'API. Bien que votre application ait besoin de plus de temps CPU pour décompresser les réponses de l'API, l'avantage de consommer moins de ressources réseau compense généralement 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 sur gzip, 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 ressource report.

  • La documentation relative aux dimensions age group et gender a été corrigée afin d'afficher les valeurs réelles que l'API renvoie pour ces dimensions. Notez qu'il s'agit d'une correction de la documentation, et ne reflète pas un changement 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 mot AGE et les chiffres de la tranche d'âge, et des traits de soulignement au lieu de traits d'union. Ainsi, les valeurs telles que age13-17 et age18-24 ont été corrigées respectivement en AGE_13_17 et AGE_18_24.
    • Les valeurs de la dimension gender utilisent des lettres majuscules. Ainsi, les valeurs female, male et gender_other ont été remplacées par FEMALE, MALE et GENDER_OTHER.

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 pris en charge une nouvelle métrique, nommée estimatedRevenue, qui fournit les mêmes données.)

Étant donné que la métrique earnings était une métrique principale, elle a été acceptée pendant un an à compter de la date de l'annonce. Cependant, cette période d'un an est arrivée à expiration. Toutefois, 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 modifié votre application pour utiliser la métrique estimatedRevenue au lieu de la métrique earnings, faites-le 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 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 date de fin est le 5 juillet 2017 et si les valeurs de toutes les métriques demandées ne sont disponibles que jusqu'au 3 juillet 2017, il s'agit de la dernière date à laquelle les données seront incluses dans la réponse. (Cela est valable même si des données sont disponibles pour certaines métriques demandées depuis le 4 juillet 2017.)

    • La dimension adType est désormais compatible avec la valeur reservedBumperInstream, qui fait référence à une annonce vidéo non désactivable de 6 secondes maximum qui est lue avant une vidéo. Le format d'annonce est identique à auctionBumperInstream, mais il fait référence aux annonces vendues sur réservation plutôt qu'aux enchères.

  • API YouTube Reporting (rapports groupés)

    • La dimension ad_type est désormais compatible avec la valeur 20, qui fait référence aux annonces bumper vendues par réservation. Les annonces bumper sont des annonces vidéo non désactivables d'une durée maximale de six secondes. Elles sont diffusées avant une vidéo. Notez que la valeur 19 pour cette dimension fait également référence aux annonces bumper qui sont vendues par mise en concurrence plutôt que par réservation.

    • Les tâches de création de rapports pour les rapports suivants de l'API YouTube Reporting ont été supprimé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

      Ces types de rapports ont été annoncés comme obsolètes le 15 septembre 2016. Ils ne sont plus générés depuis le 15 décembre 2016. Les rapports précédemment générés étaient encore disponibles pendant 180 jours à compter de leur création. Par conséquent, certains rapports étaient accessibles depuis le 15 juin 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches 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 obsolètes le 22 juin 2016. Ils ne sont plus générés depuis le 22 septembre 2016. Les rapports précédemment générés étaient encore disponibles pendant 180 jours à compter de leur création. Par conséquent, certains rapports étaient accessibles depuis le 22 mars 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches 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 les vidéos, accepte désormais les valeurs suivantes:

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87 : YouTube Kids
      • 88 : YouTube TV

      En outre, le nom utilisé pour identifier la valeur 52 a été remplacé par Kakao (Kakao Talk) dans la documentation afin de le différencier plus clairement de la valeur 73 (Kakao Story). Ce changement ne reflète aucune modification du comportement de l'API ni de la classification des vidéos partagées avec ces services.

  • API YouTube Analytics (requêtes ciblées)

    • La dimension sharingService accepte désormais les valeurs suivantes:

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 mars 2017

Les propriétaires de chaîne qui ont accès aux données sur les revenus via YouTube Analytics dans Creator Studio peuvent également y accéder via l'API YouTube Analytics:

17 mars 2017

Cette mise à jour inclut les changements suivants :

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 pour indiquer qu'elle se réfère à la période comprise entre 0h00 heure du Pacifique et à 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 auxquelles les horloges sont déplacées vers l'avant représentent une période de 23 heures, et les dates où les horloges sont ajustées en arrière représentent une période de 25 heures. (Auparavant, 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 représente pas un changement du 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 : Tizen
      • 23: Firefox
      • 24 : RealMedia
    • Toutes les tâches de reporting pour le type de rapport content_owner_basic_a1 ont été supprimées. Ce type de rapport était obsolète depuis le 19 août 2016, mais les rapports content_owner_basic_a1 générés étaient encore disponibles pendant 180 jours à compter de leur génération. Certains rapports ont donc été accessibles depuis le 19 février 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches associées ne sont pas non plus nécessaires.

  • API YouTube Analytics (requêtes ciblées)

    • La description des dimensions liées à time periods a été corrigée pour indiquer que la valeur de la dimension fait référence à la période comprise entre 0h00 heure du Pacifique et à 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 auxquelles les horloges sont déplacées vers l'avant représentent une période de 23 heures, et les dates où les horloges sont ajustées en arrière représentent une période de 25 heures. (Auparavant, la documentation indiquait que l'heure du Pacifique était UTC-8 et ne mentionnait pas la possibilité qu'une journée ne représente pas une période de 24 heures.)

      Notez que cette correction ne représente pas un changement du comportement réel de l'API.

    • La documentation sur les rapports sur les canaux a été mise à jour pour indiquer que les rapports sur les canaux ne contiennent pas actuellement les métriques sur les revenus et les performances des annonces. Par conséquent, le champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly n'autorise pas actuellement 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 include-historical-channel-data facultatif. Notez que ce paramètre n'est pertinent que lors de la récupération des rapports du propriétaire de contenu.

Ce paramètre permet à un propriétaire de contenu d'indiquer qu'une réponse de l'API doit inclure la durée de visionnage des chaînes et les données sur les vues provenant de la période précédant l'association des chaînes au propriétaire de contenu. La valeur du paramètre par défaut est false, ce qui signifie que, par défaut, la réponse de l'API n'inclut que la durée de visionnage et les données de visionnage à partir du moment où les chaînes ont été associées 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, la durée de visionnage et les données sur les vues renvoyées pour une chaîne donnée sont basées sur la date à laquelle cette chaîne a été associée au propriétaire de contenu.

    Il est important de se rappeler 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 des données pour plusieurs chaînes et que la valeur du paramètre est false, la réponse de l'API contient la durée de visionnage et la vue en fonction de la date d'association pour chaque chaîne.
  • Si la valeur du paramètre est true, la réponse renvoie la durée de visionnage et les données de vue pour toutes les chaînes 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é effectuée le 15 septembre 2016.

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 :

    L'API de création de rapports YouTube est compatible avec trois nouveaux rapports sur les écrans de fin, ainsi qu'avec 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 vidéo.

    8 novembre 2016

    Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Analytics:

    • Les métriques de la liste suivante sont complètement obsolètes et ne sont plus compatibles. 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 présente le nom de la métrique obsolète et le nouveau nom de la métrique:

      Métrique obsolète Nouvelle métrique
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    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 Creator Studio. Les nouveaux rapports d'API gérés par le système sont conçus pour fournir un accès par programmation aux données, qui sont également disponibles dans les rapports Creator Studio téléchargeables manuellement.

    La présentation des rapports gérés par le système fournit un bref aperçu des nouveaux rapports et explique le processus de récupération de ces derniers via l'API. Cette procédure est légèrement différente de celle utilisée pour les rapports groupés 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:

    • Revenus publicitaires mensuels mensuels par vidéo
    • Revenus publicitaires quotidiens par vidéo et par pays
    • Revenus publicitaires mensuels par élément dans le monde
    • Revenu publicitaire quotidien par pays et par asset
    • Revendications (ce rapport ne contient pas de données sur les revenus)

    27 septembre 2016

    Remarque:Il s'agit d'une annonce d'abandon.

    La métrique uniques de l'API YouTube Analytics est obsolète. Il ne s'agit pas d'une métrique essentielle, et elle restera 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:

    • Le rapport content_owner_basic_a1 a été entièrement obsolète et supprimé de la documentation. YouTube ne générera plus de nouveaux rapports de ce type. Toutefois, les rapports déjà disponibles resteront disponibles pendant 180 jours à compter de leur création.

      Le rapport content_owner_basic_a1 remplace celui de content_owner_basic_a2, comme expliqué dans l'entrée de l'historique des révisions du 19 mai 2016.

    11 août 2016

    Cette mise à jour inclut les changements suivants :

    • Les nouvelles conditions d'utilisation des services d'API YouTube ("Conditions mises à jour"), détaillées en détail sur le blog des ingénieurs et développeurs YouTube, contiennent de nombreuses 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 inclut plusieurs documents justificatifs pour aider les développeurs à comprendre les règles que les développeurs doivent respecter.

      L'ensemble complet de nouveaux documents est décrit dans l'historique des révisions des conditions d'utilisation mises à jour. De plus, toute modification future apportée aux Conditions mises à jour ou aux documents justificatifs sera également expliquée dans l'historique des révisions. Vous pouvez vous abonner aux modifications apportées à un flux RSS depuis cet historique des révisions à partir d'un lien dans ce document.

    10 août 2016

    Cette mise à jour inclut les modifications suivantes:

    • 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 en cours d'introduction. En effet, les anciennes métriques seront renommées, bien que l'API YouTube Analytics acceptera les deux noms de métriques jusqu'à la date d'abandon indiquée 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étrique cpm ou les deux. Toutefois, après cette date, seule la métrique cpm sera acceptée.

      • La dimension insightTrafficSourceType accepte deux nouvelles valeurs de dimension :
        • CAMPAIGN_CARD : cette source de trafic n'est acceptée que pour les rapports de propriétaires de contenu. Il indique que les vues proviennent de vidéos revendiquées mises en ligne par des utilisateurs et que le propriétaire du contenu a utilisées 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 récupérer un rapport traffic source detail pour les deux nouvelles sources de trafic. Dans les deux cas, la dimension insightTrafficSourceDetail identifie la vidéo d'où provient le spectateur.

      • La dimension adType est désormais compatible avec la valeur auctionBumperInstream, qui fait référence à une annonce vidéo non désactivable de 6 secondes maximum qui est lue avant une vidéo.

    • API YouTube Reporting (rapports groupés)

      • La dimension traffic_source_type accepte désormais les valeurs suivantes :
        • 19 : cette source de trafic n'est acceptée que pour les rapports de propriétaires de contenu. Il indique que les vues proviennent de vidéos revendiquées mises en ligne par des utilisateurs et que le propriétaire du contenu a utilisées 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 d'où provient le spectateur.

      • La liste des métriques principales de l'API a été corrigée. La liste "estimated_partner_revenue" est désormais la métrique principale et l'élément earnings a été supprimé de cette liste. La métrique earnings n'a jamais été acceptée dans l'API YouTube Reporting.

      • La dimension ad_type est désormais compatible avec la valeur 19 qui fait référence aux annonces bumper. Il s'agit d'annonces vidéo non désactivables d'une durée maximale de six secondes diffusées avant une vidéo.

    18 juillet 2016

    Cette mise à jour inclut les modifications suivantes:

    • API YouTube Analytics (requêtes ciblées)

      • Les listes des métriques acceptées dans les rapports sur les canaux suivants ont été mises à jour pour inclure les métriques des fiches. Les statistiques sur les fiches de ce rapport ont été ajoutées le 28 juin 2016. Pour en savoir plus sur les modifications apportées, reportez-vous aux entrées de l'historique des révisions pour cette date. Les rapports sont les suivants :
        • Activité de base des utilisateurs dans les États américains
        • Activité des utilisateurs aux États-Unis sur des périodes spécifiques
        • Activité des utilisateurs par province
        • Activité des utilisateurs par état d'abonnement
        • Activité des utilisateurs par abonnement dans les provinces
        • Top des vidéos par état
        • Vidéos les plus regardées par les spectateurs abonnés ou non
      • Les listes de filtres ont été corrigées à la fois pour les rapports sur la rétention d'audience de la chaîne et pour les rapports sur la rétention d'audience des propriétaires de contenu. Ces deux filtres reflètent le fait que le filtre video est obligatoire et que le filtre group n'est pas accepté.

        Auparavant, la documentation des deux rapports indiquait que le rapport pouvait être récupéré à l'aide de l'un de ces deux filtres ou de l'un d'eux.

    • API YouTube Reporting (rapports groupés)

      • Dans la présentation de l'API, la section qui explique comment récupérer l'URL de téléchargement d'un rapport a été corrigée. Elle indique que YouTube génère des rapports téléchargeables pour les jours où aucune donnée n'était disponible. Ces rapports contiennent une ligne d'en-tête, mais ne contiennent pas de données supplémentaires. 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, le nom de la dimension était card_title par erreur dans la documentation.

    28 juin 2016

    La documentation de l'API YouTube Analytics a été mise à jour afin de prendre en charge les statistiques sur les fiches dans de nombreux rapports sur les chaînes et les propriétaires de contenu. Les nouvelles métriques disponibles sont les suivantes:

    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 et les autres modifications concernent uniquement les rapports de propriétaires de contenu :

    • La section Caractéristiques des rapports de la vue d'ensemble de l'API a été mise à jour afin de préciser 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 jusqu'à 180 jours avant la date d'envoi de la requête API. Bien que techniquement vrai, le texte d'origine était au mieux plutôt déroutant.

    • L'API est compatible avec les nouvelles versions de trois rapports. Deux d'entre eux contiennent également des métriques nouvelles et renommées:

      • Le rapport content_owner_ad_rates_a1 est la nouvelle version du rapport content_owner_ad_performance_a1. Le nouveau rapport est identique à la version précédente.

      • Deux rapports comportant de nouvelles versions ont été renommés:

        • La nouvelle version du rapport content_owner_estimated_earnings_a1 s'appelle content_owner_estimated_revenue_a1.
        • La nouvelle version du rapport content_owner_asset_estimated_earnings_a1 s'appelle content_owner_asset_estimated_revenue_a1.

        Voici les différences entre les nouveaux rapports et leurs prédécesseurs:

      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 des nouvelles versions de rapport, les rapports content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 et content_owner_asset_estimated_earnings_a1 ont été abandonnés.

      Si l'un de ces rapports contient des offres d'emploi, 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 resteront disponibles pendant 180 jours à compter de leur génération.

    • La définition de la propriété id de la ressource reportType 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 afin qu'ils correspondent à ceux affichés dans les rapports. Il s'agit simplement d'un correctif de la documentation et ne reflète pas un changement dans le contenu du rapport:

      • Le nom de la métrique estimated_partner_adsense_revenue a été remplacé par estimated_partner_ad_sense_revenue. Notez toutefois que cette métrique ne s'affiche que dans deux rapports qui seront abandonnés avec cette mise à jour. Comme décrit ci-dessus, cette métrique a été renommée estimated_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é par estimated_partner_double_click_revenue. Notez que cette métrique ne s'affiche que dans deux rapports qui seront abandonnés avec cette mise à jour. Comme décrit ci-dessus, cette métrique a été renommée estimated_partner_ad_reserved_revenue dans les versions plus récentes de ces rapports.

    • La documentation relative aux dimensions de l'API de création de rapports a été mise à jour afin de ne plus répertorier les propriétés elapsed_video_time_percentage et audience_retention_type. Ces dimensions ne sont actuellement pas compatibles avec les rapports disponibles via l'API.

    19 mai 2016

    Cette mise à jour inclut les modifications suivantes de l'API YouTube Reporting:

    • 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 nouveau rapport est content_owner_basic_a2. Contrairement à la version précédente du rapport (content_owner_basic_a1), la nouvelle version accepte les métriques likes et dislikes.

      Si vous avez déjà créé un job pour le rapport content_owner_basic_a1, vous devez créer une tâche pour le rapport content_owner_basic_a2. YouTube ne transfère 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 certains cas, l'apparence d'une nouvelle tâche inattendue peut constituer un changement radical.

      Parallèlement à la sortie du nouveau rapport, le rapport content_owner_basic_a1 a été obsolète. Si une tâche est associée à 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 resteront disponibles pendant 180 jours à compter de leur génération.

    • Les ressources reportType, job et report sont toutes compatibles avec 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 ressource reportType spécifie la date et l'heure auxquelles le type de rapport sera abandonné. Cette propriété n'est associée qu'à une valeur pour les rapports qui ont été annoncés comme étant obsolètes. Cette valeur représente la date à laquelle YouTube cessera de générer des rapports de ce type.

        Lorsqu'un type de rapport est annoncé comme obsolète, YouTube génère des rapports de ce type pendant trois mois supplémentaires. Par exemple, le 19 mai 2016, nous annoncions l'abandon du rapport content_owner_basic_a1. Par conséquent, les deprecateTime de ce type de rapport indiquent une date le 19 août 2016, après laquelle YouTube cessera de générer des rapports de ce type.

      • La propriété expireTime de la ressource job spécifie la date et l'heure d'expiration de l'offre d'emploi. Cette propriété a une valeur si le type de rapport associé à la tâche est obsolète ou si les rapports générés pour la tâche ne sont pas téléchargés depuis longtemps. La date marque le moment à partir duquel YouTube ne génère plus de nouveaux rapports pour la mission.

      • La propriété jobExpireTime de la ressource report spécifie la date et l'heure d'expiration ou d'expiration de l'offre d'emploi associée au rapport. Cette propriété contient la même valeur que la propriété expireTime de la ressource job, 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 HTTP 400 (Bad Request) si vous essayez de créer une tâche pour un rapport obsolète. De plus, la documentation de la méthode répertorie désormais plusieurs autres raisons pouvant entraîner l'échec d'une requête API.

    12 avril 2016

    Cette mise à jour inclut les modifications suivantes, qui ne concernent que l'API YouTube Reporting:

    • YouTube génère désormais des données couvrant la période de 180 jours précédant la planification d'une tâche de reporting. Auparavant, l'API Reporting ne fournissait aucune donnée historique. Ce changement 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. Toutefois, l'intégration de toutes les données de l'historique à une offre d'emploi prend environ un mois. Ainsi, un mois après la planification d'une tâche de reporting, vous aurez accès à environ sept mois de données. (Toutes les données d'historique des offres d'emploi créées avant cette annonce doivent être publiées dans le mois suivant l'annonce.)

      Notez que les données de l'historique ne sont disponibles que depuis le 1er juillet 2015. En conséquence, les emplois créés avant le 28 décembre 2015 disposeront de moins de 180 jours de données d'historique.

      Toutes ces modifications sont expliquées dans la nouvelle section Données historiques de la présentation de l'API de création de rapports.

    • La section Caractéristiques des rapports de la vue d'ensemble de l'API YouTube Reporting a été modifiée, et les modifications suivantes ont été apportées:

      • La documentation indique désormais que les rapports sont disponibles pendant une période de 180 jours après leur génération et, par conséquent, peuvent être téléchargés par les clients API. Auparavant, la documentation indiquait que les rapports étaient disponibles jusqu'à six mois avant la date d'envoi de la requête API.

      • La documentation a été mise à jour afin de tenir compte du 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 contiennent des lignes d'en-tête, mais aucune donnée supplémentaire.

    • 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. Les rapports seront disponibles pour les propriétaires de contenu qui ont déjà accès aux rapports sur les revenus téléchargeables manuellement dans YouTube Creator Studio. Ainsi, la nouvelle fonctionnalité de l'API fournira un accès programmatique à ces données.

      Les modifications suivantes de l'API sont annoncées en vue du lancement des rapports gérés par le système:

      • La nouvelle propriété systemManaged de la ressource job 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, qui ne peuvent pas modifier ni supprimer les tâches qui créent ces rapports.

      • Le nouveau paramètre includeSystemManaged de la méthode jobs.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 du paramètre est false.

      • Le nouveau paramètre startTimeAtOrAfter de la méthode jobs.reports.list indique que la réponse de l'API ne doit contenir des rapports que si les données les plus anciennes sont présentes ou postérieures à la date spécifiée. De même, le paramètre startTimeBefore indique que la réponse de l'API ne doit contenir des rapports que si les données les plus anciennes sont antérieures à la date spécifiée.

        Contrairement au paramètre createdAfter de la méthode, qui concerne la création du rapport, les nouveaux paramètres concernent les données du rapport.

      • La nouvelle propriété systemManaged de la ressource reportType indique si la ressource décrit un rapport géré par le système.

      • Le nouveau paramètre includeSystemManaged de la méthode reportTypes.list indique si la réponse de l'API doit inclure des rapports gérés par le système. La valeur par défaut du paramètre est false.

    28 mars 2016

    L'API YouTube Reporting et l'API YouTube Analytics renvoient désormais des statistiques sur les vues pour plusieurs services de partage supplémentaires.

    • Dans l'API YouTube Reporting, la dimension sharing_service accepte les nouvelles valeurs suivantes :
      • 82 : boîte de dialogue "Activité du système iOS"
      • 83: boîte de réception Google
      • 84: Android Messenger
    • Dans l'API YouTube Analytics, la dimension sharingService accepte les nouvelles valeurs suivantes :
      • ANDROID_MESSENGER : Android Messenger
      • INBOX : boîte de réception Google
      • IOS_SYSTEM_ACTIVITY_DIALOG : boîte de dialogue "Activité du système iOS"

    16 mars 2016

    Cette mise à jour inclut les modifications suivantes, qui s'appliquent à l'API YouTube Reporting et à l'API YouTube Analytics:

    API YouTube Reporting

    • La dimension playback_location_type accepte deux nouvelles valeurs de dimension :
      • 7: les données concernent les vues enregistrées sur la page d'accueil ou l'écran d'accueil de YouTube, dans le flux "Abonnements" de l'utilisateur ou dans une autre fonctionnalité de navigation de YouTube.
      • 8: les données se rapportent aux vues enregistrées directement sur la page de résultats de recherche YouTube.
    • La dimension traffic_source_type est désormais compatible avec la valeur de dimension 18. Cette valeur indique que le nombre de vues de la vidéo provient d'une page d'une liste répertoriant l'ensemble des vidéos. Cette source est différente du type de source 14, qui indique que les vues se sont produites pendant la lecture de la vidéo faisant partie d'une playlist.

    API YouTube Analytics

    • La dimension insightPlaybackLocationType accepte deux nouvelles valeurs de dimension :
      • BROWSE: les données concernent les vues enregistrées sur la page d'accueil ou l'écran d'accueil de YouTube, dans le flux "Abonnements" de l'utilisateur ou dans une autre fonctionnalité de navigation de YouTube.
      • SEARCH: les données se rapportent aux vues enregistrées directement sur la page de résultats de recherche YouTube.
    • La dimension insightTrafficSourceType est désormais compatible avec la valeur de dimension YT_PLAYLIST_PAGE. Cette valeur indique que le nombre de vues de la vidéo provient d'une page d'une liste répertoriant l'ensemble des vidéos. Cette source est différente du type de source PLAYLIST, qui indique que les vues se sont produites pendant la lecture de la vidéo faisant partie d'une playlist.

    8 février 2016

    La liste des métriques compatibles avec l'API YouTube Analytics a été mise à jour afin que les statistiques des fiches ne figurent plus dans cette liste. Aucun des rapports de cette API n'a été documenté comme compatible avec les métriques des fiches.

    Sachez que vous pouvez toujours récupérer les statistiques des 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 qui se produisent via un Chromecast.

    • Dans l'API YouTube Reporting, la dimension operating_system utilise la valeur 21 pour identifier les vues qui se produisent via Chromecast.
    • Dans l'API YouTube Analytics, la dimension operatingSystem utilise la valeur CHROMECAST pour identifier les vues qui se produisent via 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 affichés dans les rapports. Auparavant, les noms étaient indiqués sous les noms clickable_annotation_impressions et closable_annotation_impressions.

    18 décembre 2015

    Les lois de l'Union européenne (UE) imposent la divulgation de certaines informations et le consentement des utilisateurs finaux dans l'UE. Par conséquent, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE pour les utilisateurs finaux de l'Union européenne. Nous avons ajouté une notification concernant cette exigence dans les Conditions d'utilisation de l'API YouTube.

    15 décembre 2015

    Cette mise à jour inclut les modifications suivantes, qui ont toutes un impact sur l'API YouTube Analytics:

    • L'API YouTube Analytics est désormais compatible avec trois nouvelles dimensions associées aux 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é des utilisateurs qui a eu lieu pendant une diffusion en direct.
      • subscribedStatus : cette dimension indique si les métriques d'activité des utilisateurs dans les données sont associées aux spectateurs qui sont 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 sont les suivantes : site Web principal (ou application YouTube), YouTube Gaming et YouTube Kids.

      La documentation a été mise à jour pour identifier les nouveaux rapports détaillés sur les lectures disponibles pour les chaînes et les propriétaires de contenu. En outre, de nombreux autres rapports ont été mis à jour afin de signaler qu'une ou plusieurs de ces dimensions peuvent éventuellement être utilisées comme dimensions et/ou filtres dans ces rapports.

    • Le format des tableaux expliquant les rapports a été modifié pour vous permettre d'identifier plus facilement des combinaisons valides de dimensions, de métriques et de filtres permettant de récupérer chaque rapport. Le tableau ci-dessous, qui explique le rapport "Type d'appareil" pour les chaînes, présente le nouveau format:

      Sommaire
      Dimensions :
      Obligatoire deviceType (Type d'appareil)
      Utiliser 0 ou plus day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Métriques :
      Utilisez 1 ou plusieurs vues, estimatedMinutesWatched
      Filtres :
      Utiliser 0 ou 1 country, province, continent, subContinent
      Utiliser 0 ou 1 vidéo, groupe
      Utiliser 0 ou plus OperatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      La terminologie relative aux champs obligatoires et facultatifs est expliquée dans la documentation concernant les rapports sur les chaînes et les propriétaires de contenu.

    • L'API YouTube Analytics supprime désormais automatiquement les entités pour lesquelles l'utilisateur de l'API ne peut pas récupérer les données des filtres compatibles avec plusieurs valeurs (video, playlist et channel). 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.

      Par exemple, supposons qu'un utilisateur envoie une requête API dans laquelle le filtre video répertorie 20 ID vidéo. L'utilisateur possède 18 des vidéos. Toutefois, un ID de vidéo identifie une vidéo appartenant à une autre chaîne, tandis qu'un autre ID identifie une vidéo supprimée qui n'existe 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 des 18 vidéos que possède l'utilisateur de l'API.

    • Si vous demandez des données pour un group YouTube Analytics vide, l'API affiche 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 HTTP 403) 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 elle renvoyait ultérieurement une erreur non autorisée lorsque vous tentiez de récupérer les données de rapport 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ètre nextPageToken de la réponse spécifie un jeton pouvant être utilisé pour récupérer la page de résultats suivante. Définissez le paramètre pageToken de la méthode sur cette valeur pour récupérer des résultats supplémentaires.

    10 novembre 2015

    Cette mise à jour inclut les changements suivants :

    29 octobre 2015

    Cette mise à jour inclut les changements suivants :

    • La documentation concernant la dimension date de l'API de création de rapports YouTube a été corrigée afin de refléter les dates qui font référence à la période de 24 heures à 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 de date (day, 7DayTotals, 30DayTotals et month) 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 accepte désormais le paramètre de requête createdAfter. 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 de remplissage. Notez que la valeur du paramètre correspond à la date de création du rapport et non aux dates associées aux données renvoyées.

      La valeur du paramètre est un horodatage au format RFC3339 UTC "Zulu", précis à la microseconde près. Exemple : "2015-10-02T15:01:23.045678Z"

      Les bonnes pratiques de l'API YouTube Reporting ont également été mises à jour afin d'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 ressource job et des propriétés startTime, endTime et createTime de la ressource report ont toutes été corrigées. Notez que les valeurs des propriétés sont précises à la microseconde au lieu de nanosecondes. En outre, toutes les définitions reflètent désormais avec précision que la valeur de la propriété est un horodatage.

    8 octobre 2015

    Cette mise à jour inclut les changements suivants :

    • La documentation de la dimension sharingService de l'API YouTube Analytics a été mise à jour pour inclure une liste des valeurs possibles. Cette 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 pour afficher les nouvelles valeurs acceptées. Les valeurs d'énumération supérieures à 59 sont les nouvelles valeurs de la liste.

    24 septembre 2015

    Cette mise à jour inclut les changements suivants :

    • La nouvelle API de création de rapports YouTube permet de récupérer des rapports groupés contenant des données YouTube Analytics concernant une chaîne ou un propriétaire de contenu. Il est conçu pour les applications capables d'importer de grands ensembles de données et qui fournissent des outils pour 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 possède une combinaison unique de valeurs de dimension. Vous pouvez agréger les données des lignes en fonction des valeurs de dimension pour calculer les métriques de vidéos individuelles, de pays, de vidéos en direct, d'utilisateurs abonnés, etc.

      Vous pouvez utiliser l'API pour planifier des tâches de création de rapports, chacune identifiant un rapport que YouTube doit générer. Une fois que vous avez configuré un job, YouTube génère un rapport quotidien qui peut être téléchargé de manière asynchrone. Chaque rapport contient des données sur une période de 24 heures.

    • Bien qu'il s'agisse d'API différentes, l'API YouTube Analytics et l'API YouTube Reporting permettent aux développeurs de récupérer les données YouTube Analytics. Étant donné que les deux API donnent accès à des ensembles de données similaires, la documentation des deux API est publiée sous la forme d'un seul ensemble de documentation.

      • L'onglet Guides de la 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 de création de rapports YouTube.
      • L'onglet Requêtes ciblées contient de la documentation de référence ainsi que d'autres contenus spécifiques à l'API YouTube Analytics.
      • L'onglet Exemples répertorie des exemples de code disponibles pour l'une des deux API.
      • L'onglet Outils répertorie des ressources supplémentaires disponibles pour aider les développeurs à implémenter l'une des deux API.

    20 août 2015

    Cette mise à jour inclut les changements suivants :

    • La documentation de l'API a été restructurée afin de faciliter sa 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 disponibles et une autre liste qui répertorie tous les rapports de propriétaires de contenu disponibles. Auparavant, la documentation comportait des pages distinctes pour les rapports sur les vidéos de la chaîne, les rapports sur les playlists de chaîne, etc.

      • La nouvelle présentation du modèle de données vise à fournir une présentation plus claire du fonctionnement de l'API. Plus précisément, ce document essaie 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, qui vous permet de récupérer des rapports, est maintenant documentée séparément. Les informations figurant sur cette page figuraient auparavant sur d'autres pages. La nouvelle page a été conçue pour vous aider à identifier plus facilement les informations à envoyer pour récupérer un rapport.

    22 juillet 2015

    Cette mise à jour inclut plusieurs modifications, qui ne s'appliquent qu'aux propriétaires de contenu:

    • La nouvelle métrique "adEarnings" comprend les revenus estimés totaux (revenus nets) de toutes les sources publicitaires vendues par Google. Il ne s'agit pas d'une métrique essentielle. L'API accepte la métrique adEarnings pour tous les rapports qui acceptent déjà la métrique earnings.

      En outre, la définition de la métrique earnings tient compte du fait que sa valeur inclut le total des revenus estimés provenant de toutes les sources publicitaires vendues par Google et d'autres sources. Auparavant, la définition indiquait que la métrique ne comprenait que les revenus provenant de sources publicitaires.

    • La métrique primaryAdGrossRevenue est obsolète. Utilisez plutôt la métrique grossRevenue 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 ne sont plus compatibles avec les métriques monetizedPlaybacks et playbackBasedCpm. Cependant, plusieurs rapports sur les vidéos sont toujours compatibles avec ces métriques.

    1er juin 2015

    Cette mise à jour inclut les changements suivants :

    • L'API accepte désormais deux nouvelles métriques pour les rapports sur les vidéos : videosAddedToPlaylists et videosRemovedFromPlaylists. La liste des rapports sur les vidéos pour les chaînes et les propriétaires de contenu a été mise à jour pour identifier les rapports compatibles avec les nouvelles métriques.

      • videosAddedToPlaylists : nombre de fois où des vidéos incluses dans la requête ont été ajoutées à des playlists YouTube. Les vidéos peuvent avoir été ajoutées à la playlist du propriétaire de la vidéo ou à celles d'autres chaînes.
      • videosRemovedFromPlaylists : nombre de fois où des vidéos incluses dans la requête ont été supprimées d'une playlist YouTube. Les vidéos ont pu être supprimées de la playlist du propriétaire de la vidéo ou des playlists d'autres chaînes.

      Ces deux métriques incluent les playlists par défaut comme "À regarder plus tard". Cependant, ils ne comptabilisent pas les playlists auxquelles une vidéo a été ajoutée automatiquement, comme la playlist des vidéos mises en ligne sur une chaîne ou l'historique des vidéos regardées par 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 à nouveau, les métriques indiquent que la vidéo a été ajoutée à deux playlists et supprimée d'une playlist.

      Les données de ces métriques sont disponibles depuis le 1er octobre 2014.

    31 mars 2015

    Cette mise à jour inclut les changements suivants :

    16 mars 2015

    Cette mise à jour inclut les changements suivants :

    • 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). Si le paramètre est défini, l'API convertit les valeurs des métriques earnings, grossRevenue, playbackBasedCpm et impressionBasedCpm dans la devise spécifiée. Les valeurs renvoyé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 à trois lettres ISO 4217. La valeur par défaut est USD. La définition du paramètre contient une liste des codes de devise acceptés.

    25 février 2015

    Cette mise à jour inclut les changements suivants :

    • L'API vous permet désormais de créer et de gérer des groupes YouTube Analytics, et de récupérer les données des rapports pour ces groupes.

      • Créer et gérer des groupes

        Cette mise à jour introduit les ressources group et groupItem pour créer et 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 assets. L'API accepte les méthodes list, insert, update et delete pour cette ressource.
        • La ressource groupItem représente un élément d'un groupe Analytics. L'API accepte les méthodes list, insert et delete 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éthode groupItems.insert.

      • Récupérer les données de rapport d'un groupe

        La documentation relative aux dimensions a été mise à jour pour inclure la dimension group, qui peut servir de filtre pour de nombreux rapports sur les chaînes et rapports sur les propriétaires de contenu. Lorsque vous utilisez le filtre group, l'API renvoie des données pour tous les éléments de ce groupe. Notez que l'API ne permet pas de créer des rapports pour les groupes d'assets pour le moment.

      Pour en savoir plus sur les groupes YouTube Analytics, consultez le Centre d'aide YouTube.

    13 février 2015

    Cette mise à jour inclut les changements suivants :

    • L'API n'est plus compatible avec la dimension show.

    28 août 2014

    Cette mise à jour inclut les changements suivants :

    • L'API permet désormais de spécifier plusieurs valeurs pour les dimensions video, playlist, channel et show lorsque celles-ci sont utilisées en tant que filtres. Pour spécifier plusieurs valeurs, définissez le paramètre filters sur une liste d'ID vidéo, de playlist, de chaîne ou d'émission séparés par des virgules pour lesquels la réponse de l'API doit être filtrée. 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 requête. Cela est valable même si le filtre n'est pas répertorié en tant que dimension compatible 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é.

    16 juillet 2014

    Cette mise à jour inclut les changements suivants :

    • Lorsque vous récupérez un rapport sur un canal, vous pouvez maintenant récupérer les données du canal de l'utilisateur authentifié en définissant la valeur du paramètre ids sur channel==MINE. (Vous pouvez également définir le paramètre ids sur channel==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 cadre 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 et estimatedMinutesWatched, et certains sont également compatibles avec la métrique averageViewDuration.

      En outre, tous les rapports sur les playlists sont compatibles avec les nouvelles métriques suivantes. Notez que chacune de ces métriques ne reflète que les vues de playlists enregistrées sur le Web.

      • playlistStarts : nombre de lancements d'une playlist par des spectateurs.
      • viewsPerPlaylistStart: nombre moyen de vues de vidéos à chaque lecture d'une playlist.
      • averageTimeInPlaylist : estimation de la durée moyenne, en minutes, pendant laquelle un spectateur a regardé des vidéos d'une playlist après son lancement.

      Toute demande de récupération d'un rapport de playlist doit utiliser le filtre isCurated, qui doit être défini sur 1 (isCurated==1).

    • L'API est désormais compatible avec 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 de la vidéo écoulée pour les métriques correspondantes:

      • La métrique audienceWatchRatio permet d'identifier le ratio absolu des spectateurs qui regardent la vidéo à un moment donné de la vidéo. Le ratio est calculé en comparant le nombre de fois où une partie d'une vidéo a été regardée au nombre total de vues de la vidéo.

        Sachez qu'une partie d'une vidéo peut être visionnée plusieurs fois (ou pas du tout) dans une même vue. Par exemple, si les utilisateurs retournent en arrière et regardent la même partie de la vidéo plusieurs fois, le ratio absolu de cette partie de la vidéo peut être supérieur à 1.

      • La métrique "relativeRetentionPerformance" indique la capacité d'une vidéo à fidéliser les spectateurs lors de la lecture, par rapport à toutes les vidéos YouTube de durée similaire. Une valeur de 0 indique que la vidéo retient plus l'attention des spectateurs que toute autre vidéo de durée similaire. Une valeur de 1 indique que la vidéo retient mieux l'audience que les autres vidéos de durée similaire. Une valeur médiane de 0,5 indique que la moitié des vidéos de durée similaire fidélisent mieux les spectateurs, tandis que la moitié fidélise le moins les spectateurs.

      Vous pouvez aussi utiliser le filtre audienceType afin que le rapport n'affiche que les données associées aux vues naturelles, aux vues des annonces TrueView InStream ou aux vues des annonces TrueView InDisplay. Les vues naturelles sont le résultat direct d'une action de l'utilisateur, telle qu'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. Vous pouvez récupérer les métriques ci-dessous dans tous les rapports compatibles avec les métriques annotationClickThroughRate et annotationCloseRate.

      Toutes les nouvelles métriques sont des métriques de base et sont soumises au Règlement relatif aux abandons. Toutefois, notez que les données sont disponibles pour les nouvelles statistiques à compter du 16 juillet 2013. Les données des statistiques annotationClickThroughRate et annotationCloseRate sont disponibles depuis le 10 juin 2012.

    • GOOGLE_SEARCH n'est plus indiqué comme valeur distincte pour la dimension insightTrafficSourceType. À 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, il n'est plus possible de récupérer un rapport insightTrafficSourceDetail qui définit le filtre insightTrafficSourceType sur GOOGLE_SEARCH.

    31 janvier 2014

    Cette mise à jour inclut les changements suivants :

    16 janvier 2014

    Cette mise à jour inclut les changements suivants :

    • L'exemple de demande a été repensé pour regrouper les exemples par catégories, à l'aide d'un format d'onglet similaire à celui des derniers 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ée sur l'heure
      • Ciblage géographique
      • Contexte de lecture
      • Source de trafic
      • Appareil/OS
      • Catégorie démographique
      • Réseau social
      • Revenus/annonces (pour les rapports de propriétaire de contenu uniquement)

    • L'exemple de demande inclut désormais de nouveaux exemples pour récupérer les données spécifiques à une province dans les rapports sur les chaînes ou sur les propriétaires de contenu.

      • Métriques spécifiques aux provinces pour les États américains et la Washington D.C. : Ce rapport présente la répartition par province du nombre de vues et d'autres statistiques relatives aux vidéos d'une chaîne. Les données couvrent les États des États-Unis et Washington D.C. L'exemple utilise la dimension province, et utilise également le paramètre filters pour limiter la réponse à n'inclure que les résultats pour les États-Unis.

      • Données démographiques des spectateurs en Californie (tranche d'âge et sexe) : ce rapport récupère des statistiques sur la tranche d'âge et le genre des spectateurs qui ont regardé les vidéos d'une chaîne ou, pour les rapports de propriétaire de contenu, le contenu revendiqué par un propriétaire de contenu. Cet exemple utilise le paramètre filters pour s'assurer 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 lorsque province est inclus dans la valeur du paramètre dimensions, la requête doit également restreindre les données aux États-Unis en incluant country==US dans la valeur du paramètre filters.

    6 janvier 2014

    Cette mise à jour inclut les changements suivants :

    • 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 répertoriant tous les rapports possibles, chaque document regroupe les rapports par catégories:

      • Statistiques de base
      • Basée sur l'heure
      • Ciblage géographique
      • Contexte de lecture
      • Source de trafic
      • Appareil/OS
      • Catégorie démographique
      • Réseau social
      • Vidéos les plus regardées

      Chaque catégorie affiche ces catégories sous la forme d'une liste d'onglets. Vous pouvez cliquer sur n'importe quel onglet pour afficher les rapports correspondants dans cette catégorie.

    • L'API accepte désormais trois nouvelles dimensions géographiques : province, continent et subContinent.

      • La dimension province vous permet d'obtenir des statistiques sur les États des États-Unis et sur le District de Colombie. L'API accepte deux utilisations pour cette dimension:

        • L'API est compatible avec deux rapports qui décomposent les statistiques en fonction de l'état. Ces deux rapports sont disponibles pour les chaînes et les propriétaires de contenu.

          • Le rapport principal fournit plusieurs statistiques, dont le nombre de vues et une estimation du nombre de minutes regardées.
          • Le rapport basé sur le temps fournit les mêmes statistiques, mais agrège les données sur une base quotidienne, 7 jours, 30 jours ou mensuel.

        • Vous pouvez utiliser le paramètre de requête filters pour limiter un rapport afin qu'il ne contienne que les statistiques d'un état particulier. Plusieurs types de filtres sont compatibles avec ce type de filtrage, y compris les rapports géographiques, les rapports sur le contexte de lecture, les rapports sur les sources de trafic, les rapports sur les appareils, les rapports sur le système d'exploitation, les rapports sur les performances démographiques et les rapports sur les vidéos les plus regardées.

      • La dimension continent spécifie un code de région statistique des Nations Unies (UN) qui identifie un continent. Cette dimension ne peut être utilisée que comme filtre.

      • La dimension subContinent spécifie un code de région statistique des Nations Unies (UN) qui identifie une sous-région d'un continent. Cette dimension ne peut également servir que de filtre.

        Étant donné que chaque sous-région n'est associée qu'à un seul continent, vous n'avez pas besoin d'utiliser le filtre continent lorsque vous utilisez le filtre subContinent. En fait, l'API renvoie une erreur si une requête utilise les deux dimensions.

    • La documentation a été corrigée. La dimension insightTrafficSourceDetail n'inclut donc pas la valeur insightTrafficSourceType PROMOTED en tant que valeur de filtre valide.

    30 septembre 2013

    Cette mise à jour inclut les changements suivants :

    • L'API YouTube Analytics est désormais soumise aux règles d'abandon décrites dans les Conditions d'utilisation. Toutefois, les dimensions et métriques non principales de l'API ne sont pas soumises au règlement relatif aux abandons. Les pages Dimensions et Métriques ont été mises à jour pour lister les dimensions et métriques principales. De plus, les définitions de ces pages ont été mises à jour afin d'identifier explicitement les dimensions et métriques principales.

    • L'API accepte désormais EXTERNAL_APP comme valeur pour la dimension insightPlaybackLocationType. Parallèlement à cette mise à jour, depuis le 10 septembre 2013, les lectures ne sont plus classées dans la catégorie MOBILE ; les lectures sur mobile antérieures à cette date seront tout de même classées dans cette catégorie.

      Avec cette mise à jour, les lectures sur mobile sont désormais classées en tant que lectures WATCH, EMBEDDED ou EXTERNAL_APP, selon le type d'application où les lectures se produisent.

    • L'API accepte désormais PLAYLIST comme valeur pour la dimension insightTrafficSourceType. La valeur indique que les vues de la vidéo proviennent d'une playlist. Auparavant, ces vues auraient été classées à l'aide de la catégorie YT_OTHER_PAGE de la dimension.

    16 juillet 2013

    Cette mise à jour inclut les changements suivants :

    • L'API permet désormais de trier les rapports selon plusieurs dimensions et métriques. L'exemple de document sur les demandes contient un nouvel exemple, Tri des requêtes selon plusieurs dimensions/métriques, qui illustre cette fonctionnalité. La requête récupère les données de source de trafic et a une valeur de paramètre sort de day,-views. Les résultats sont triés par ordre chronologique. Cependant, dans l'ensemble de résultats pour chaque jour, la première ligne contient les données de la source de trafic ayant généré le plus de vues, la deuxième ligne contient les données de la source ayant généré le nombre de vues le plus élevé suivant, etc.

    • L'API accepte désormais deux nouvelles dimensions, deviceType et operatingSystem, qui permettent d'obtenir 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 des dimensions ou les deux.

      • 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 filtre operatingSystem pour limiter le rapport sur les types d'appareils afin qu'il ne contienne que les statistiques des appareils exécutant un système d'exploitation spécifique, comme Android ou iOS.

      • Le rapport operatingSystem vous permet de connaître le nombre de vues et la durée de visionnage estimée pour différents systèmes d'exploitation (Android, iOS, Linux, etc.). Vous pouvez également utiliser le filtre deviceType pour limiter le rapport au système d'exploitation afin qu'il ne contienne que les statistiques d'un type d'appareil spécifique, tel que les appareils mobiles ou les tablettes.

      Les nouveaux rapports sur les types d'appareils et les systèmes d'exploitation sont disponibles pour les chaînes et pour les propriétaires de contenu.

    • L'exemple de demande 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 valeur YT_OTHER, qui identifie les vues qui ne sont pas classées à l'aide de l'une des autres valeurs de la dimension.

    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 :

    • L'API permet désormais de récupérer des métriques sur la durée de visionnage (estimatedMinutesWatched, averageViewDuration et averageViewPercentage) en plus d'autres métriques, dont 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 des propriétaires de contenu disponibles ont été mises à jour pour refléter cette modification. (Les listes sont actuellement plus courtes, car les métriques sur la durée de visionnage peuvent être récupérées dans d'autres rapports listés.)

      Le document Exemples de requêtes API a également été mis à jour.

    • Les rapports qui utilisent les dimensions insightPlaybackLocationDetail et insightTrafficSourceDetail ont été améliorés de la manière suivante:

      • Elles acceptent désormais un filtre country facultatif.

      • Les propriétaires de contenu peuvent désormais récupérer ces rapports en utilisant l'une des nouvelles combinaisons filter suivantes. Notez que toutes ces combinaisons sont également compatibles avec le filtre facultatif country.

        • Détails du 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

    3 mai 2013

    Cette mise à jour inclut les changements suivants :

    • 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 que la demande récupère, puis affiche les dimensions, les métriques, les filtres et les paramètres de tri de la demande.

    • La dimension insightTrafficSourceType accepte désormais SUBSCRIBER comme valeur valide. Cette valeur identifie les vues de vidéo provenant de flux sur la page d'accueil YouTube ou de fonctionnalités d'abonnement YouTube. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie le flux de page d'accueil ou une autre page à partir de laquelle les vues ont été générées.

    28 mars 2013

    Cette mise à jour inclut les changements suivants :

    21 mars 2013

    Cette mise à jour inclut les changements suivants :

    • L'API prend désormais en charge les métriques sur les revenus et les performances des annonces, ainsi que les nouveaux rapports sur les performances des annonces. Les métriques et les rapports ne sont accessibles que pour les partenaires de contenu YouTube qui participent au Programme Partenaire YouTube.

      • Les nouveaux rapports sont compatibles avec les métriques de performances des annonces basées sur les lectures et sur les impressions. Pour en savoir plus, consultez la documentation sur les rapports de propriétaires de contenu.

      • Les nouvelles métriques compatibles sont listées ci-dessous. La liste des rapports de propriétaires de contenu a été mise à jour pour identifier les rapports compatibles, y compris les deux nouveaux.

        • earnings : total des revenus estimés provenant de toutes les sources publicitaires vendues par Google.
        • grossRevenue : revenus bruts estimés provenant de Google ou de partenaires DoubleClick.
        • primaryAdGrossRevenue : revenus bruts estimés, additionnés et classés en fonction du type d'annonce principal pour les lectures vidéo couvertes par le rapport, provenant de Google ou de partenaires DoubleClick.
        • monetizedPlaybacks : nombre de lectures qui ont 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 obtenir des informations complètes, consultez les définitions des métriques.

      • Toute demande qui récupère les 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 relative à l'API a été réorganisée pour expliquer les différents types de rapports sur des pages distinctes. Par conséquent, des pages distinctes permettent désormais d'expliquer les différents types de rapports sur les chaînes et de rapports de propriétaires de contenu.

    4 février 2013

    Cette mise à jour inclut les changements suivants :

    • Le guide de référence de l'API comporte maintenant une section examples, qui inclut des exemples de code montrant comment appeler l'API à l'aide des bibliothèques clientes Java, JavaScript, Python et Ruby. L'exemple de code JavaScript est identique à celui détaillé dans la documentation de l'exemple d'application.

    14 novembre 2012

    Cette mise à jour inclut les changements suivants :

    • Le guide de référence de l'API inclut désormais APIs Explorer, qui vous permet d'appeler l'API, d'afficher la requête d'API et de récupérer les données réelles dans la réponse.

    • L'API est compatible avec un certain nombre de nouveaux rapports, décrits ci-dessous, pour les chaînes et les propriétaires de contenu. Chaque rapport est disponible sous forme de rapport de chaîne ou de rapport de propriétaire de contenu. Les pages relatives aux dimensions et aux statistiques ont également été mises à jour en conséquence.

      • Le rapport sur le contexte de lecture indique le nombre de vues de vidéos ayant eu lieu sur différents types de pages ou d'applications.

      • Le rapport "Contextes de lecture" indique les lecteurs intégrés qui ont généré le plus de vues pour une vidéo donnée. Il offre une vue plus détaillée que le rapport sur le contexte de lecture en identifiant les URL associées aux principaux lecteurs intégrés.

      • Le rapport sur les sources de trafic identifie le nombre de vues provenant de différents types d'URL de provenance.

      • Le rapport "Infos sur la source de trafic" identifie les URL de provenance qui ont généré le plus de vues pour une vidéo et un type de source spécifiques. 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 passent à regarder vos contenus. Les rapports peuvent regrouper les données pour une période spécifique (un jour, les sept derniers jours, les 30 jours précédents, etc.) ou un pays. Si un rapport regroupe des données par jour ou par pays, il peut également spécifier la durée moyenne de chaque vue de vidéo, ainsi que le pourcentage moyen de chaque vidéo regardée par les utilisateurs.

    2 octobre 2012

    Cette mise à jour inclut les changements suivants :

    • Le YouTube Analytics API est maintenant disponible pour tous les développeurs. Vous pouvez activer l'API pour votre projet, sans avoir à demander d'accès au préalable, dans le panneau Services de APIs console.

    • La nouvelle section Premiers pas présente les conditions préalables et les étapes de base pour créer une application utilisant YouTube Analytics API.

    12 septembre 2012

    Cette mise à jour inclut les changements suivants :

    • La nouvelle section Comprendre l'utilisation du quota fournit des consignes pour optimiser votre utilisation du quota d'API. Le serveur d'API calcule le coût de chaque requête et déduit de votre quota d'utilisation d'API. Étant donné que les coûts liés aux requêtes peuvent varier considérablement d'un type de rapport à l'autre, vous devez prévoir d'utiliser efficacement votre quota, 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 sur une période donnée. L'API est désormais compatible avec les dimensions temporelles supplémentaires suivantes:

      • 7DayTotals : les données du rapport seront agrégées de sorte que chaque ligne contienne des données sur une période de sept jours.
      • 30DayTotals : les données du rapport seront agrégées de sorte que chaque ligne contienne des données sur une période de 30 jours.
      • month : les données du rapport seront agrégées par mois civil.

      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 sur les dimensions des entités de rapport a été mise à jour pour indiquer que les demandes d'API permettant de récupérer les rapports des propriétaires de contenu doivent filtrer les données selon l'une de ces dimensions (video, channel ou show) ou une combinaison compatible des dimensions claimedStatus et uploaderType.

    • L'API accepte désormais deux nouvelles options de tri pour les rapports sur les vidéos les plus regardées. Ces rapports sont disponibles sous forme de rapports sur les chaînes ou sur les propriétaires de contenu. Ils contiennent des métriques (vues, commentaires, "J'aime", etc.) par pays et détaillent ces métriques 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 de la page de lecture de la vidéo.

    • Les définitions des métriques subscribersGained et subscribersLost ont été mises à jour 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 disponible sur la page d'accueil YouTube. Lorsque ces métriques apparaissent dans un rapport spécifique à une vidéo, elles n'incluent que les statistiques de la page de lecture de la vidéo en question.