Historique des révisions

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

7 avril 2024

L'API YouTube Analytics (Requêtes ciblées) a fait l'objet de plusieurs mises à jour concernant les rapports sur les playlists des propriétaires de contenu. Les modifications sont les mêmes que celles concernant les rapports sur les playlists de chaînes annoncées le 19 janvier 2024.

L'entrée suivante de l'historique des révisions fournit presque les mêmes informations que l'entrée du 19 janvier 2024. Notez toutefois que les rapports sur les playlists des propriétaires de contenu seront compatibles avec la dimension isCurated jusqu'au 31 décembre 2024, tandis que cette dimension sera disponible pour les rapports sur les playlists de chaînes jusqu'au 30 juin 2024.

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

  La dimension isCurated a été abandonnée dans les rapports sur les playlists des propriétaires de contenu. Elle ne sera plus prise en charge à compter du 31 décembre 2024. La définition de cette dimension a été mise à jour en conséquence.

  Pour préserver la rétrocompatibilité lorsque vous supprimez la dimension isCurated, vous devez également mettre à jour votre code afin de récupérer la métrique playlistViews au lieu de la métrique views pour les rapports sur les playlists uniquement. La métrique views étant toujours compatible avec les rapports sur les playlists, bien qu'elle ait une signification différente, l'API affichera toujours des données si vous ne mettez pas à jour le nom de la métrique. Bien entendu, vous pouvez modifier votre application pour récupérer et afficher à la fois views et playlistViews.

  Outre la dimension isCurated, les fonctionnalités d'API suivantes ne sont plus disponibles dans les nouveaux rapports:

  • Les filtres de lieu, tels que continent et subcontinent, ne sont pas compatibles avec les nouveaux rapports sur les playlists de chaînes.
  • Les métriques redViews et estimatedRedMinutesWatched ne sont plus compatibles avec les nouveaux rapports sur les playlists de chaînes. Ces métriques n'étant pas disponibles dans YouTube Studio, ce changement aligne les fonctionnalités de l'API et celles de l'application Studio.
  • Les dimensions subscribedStatus et youtubeProduct ne peuvent plus servir de filtres pour les rapports sur les playlists de chaînes. Ces filtres n'étaient pas disponibles dans YouTube Studio. Par conséquent, cette modification aligne les fonctionnalités de l'API avec celles disponibles dans l'application Studio.

• La section Rapports sur les playlists de la documentation sur les rapports de propriétaires de contenu a été mise à jour pour expliquer plus en détail les types de métriques compatibles avec les rapports sur les playlists:

  • Les métriques vidéo cumulées fournissent des métriques sur l'activité et les impressions des utilisateurs, regroupées pour toutes les vidéos dans les playlists du propriétaire de contenu, qui appartiennent également à ce propriétaire. Les métriques agrégées sur les vidéos ne sont compatibles qu'avec les requêtes API qui n'utilisent pas la dimension isCurated.
  • Les métriques dans les playlists reflètent l'activité et l'engagement des utilisateurs sur la page de la playlist. Ces métriques incluent également les vues des vidéos qui ne vous appartiennent pas dans la playlist, mais uniquement lorsque ces vues ont eu lieu dans le contexte de la playlist.
  • La section Métriques sur les playlists compatibles identifie les métriques agrégées sur les vidéos et les métriques sur les playlists qui sont compatibles avec les rapports sur les playlists.

• Les nouvelles métriques Dans les playlists suivantes sont disponibles dans les rapports sur les playlists des propriétaires de contenu. Notez que ces métriques ne sont disponibles que si la requête API permettant de récupérer les rapports n'utilise pas la dimension isCurated. Consultez la documentation sur les metrics pour obtenir la définition de chaque métrique:

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

• Le comportement de la métrique views varie désormais selon que la requête API qui récupérait le rapport sur les playlists a utilisé la dimension isCurated ou non:

  • Lorsqu'une demande inclut la dimension isCurated, la métrique views est une métrique dans une playlist qui indique le nombre de fois où des vidéos ont été regardées dans le contexte des playlists du propriétaire de contenu.
  • Lorsqu'une demande n'inclut pas la dimension isCurated, la métrique views est une métrique vidéo agrégée qui indique le nombre total de fois où les vidéos figurant dans les playlists du propriétaire de contenu ont été regardées, que ces vues aient eu lieu ou non dans le contexte de la playlist. Le total cumulé n'inclut que les vues des vidéos appartenant au propriétaire de contenu associé à la chaîne à laquelle la playlist appartient.
    
    Dans ces rapports, qui n'utilisent pas la dimension isCurated, la métrique playlistViews indique le nombre de fois où des vidéos ont été regardées dans le contexte d'une playlist. Cette métrique comptabilise les vues pour toutes les vidéos de la playlist, quelle que soit la chaîne sur laquelle elles sont propriétaires.

• Pour chaque rapport sur les playlists, la documentation des rapports sur les propriétaires de contenu inclut désormais des tableaux affichant les métriques compatibles pour ce rapport, selon que la requête API inclut ou non la dimension isCurated. Pour obtenir un exemple, consultez la section concernant les rapports sur les playlists temporelles.

19 janvier 2024

L'API YouTube Analytics (Targeted Query) a fait l'objet de plusieurs mises à jour concernant les rapports sur les playlists de chaînes. Les mises à jour incluent une dimension obsolète, ainsi que plusieurs nouvelles métriques et mises à jour:

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

  La dimension isCurated a été abandonnée pour les rapports d'analyse des canaux. Elle ne sera plus disponible à compter du 30 juin 2024. La définition de cette dimension a été modifiée en conséquence.

  Pour préserver la rétrocompatibilité lorsque vous supprimez la dimension isCurated, vous devez également mettre à jour votre code afin de récupérer la métrique playlistViews au lieu de la métrique views pour les rapports sur les playlists uniquement. La métrique views étant toujours compatible avec les rapports sur les playlists, bien qu'elle ait une signification différente, l'API affichera toujours des données si vous ne mettez pas à jour le nom de la métrique. Bien entendu, vous pouvez modifier votre application pour récupérer et afficher à la fois views et playlistViews.

  Outre la dimension isCurated, les fonctionnalités d'API suivantes ne sont plus disponibles dans les nouveaux rapports:

  • Les filtres de lieu, tels que continent et subcontinent, ne sont pas compatibles avec les nouveaux rapports sur les playlists de chaînes.
  • Les métriques redViews et estimatedRedMinutesWatched ne sont plus compatibles avec les nouveaux rapports sur les playlists de chaînes. Ces métriques n'étant pas disponibles dans YouTube Studio, ce changement aligne les fonctionnalités de l'API et celles de l'application Studio.
  • Les dimensions subscribedStatus et youtubeProduct ne peuvent plus servir de filtres pour les rapports sur les playlists de chaînes. Ces filtres n'étaient pas disponibles dans YouTube Studio. Par conséquent, cette modification aligne les fonctionnalités de l'API avec celles disponibles dans l'application Studio.

• La section Rapports sur les playlists de la documentation sur les rapports sur les chaînes a été mise à jour pour expliquer plus en détail les types de métriques compatibles avec les rapports sur les playlists:

  • Les métriques vidéo cumulées fournissent des métriques sur l'activité et les impressions des utilisateurs, regroupées pour toutes les vidéos des playlists de la chaîne qui appartiennent également à la chaîne. Les métriques agrégées sur les vidéos ne sont compatibles qu'avec les requêtes API qui n'utilisent pas la dimension isCurated.
  • Les métriques dans les playlists reflètent l'activité et l'engagement des utilisateurs sur la page de la playlist. Ces métriques incluent également les vues des vidéos qui ne vous appartiennent pas dans la playlist, mais uniquement lorsque ces vues ont eu lieu dans le contexte de la playlist.
  • La section Métriques sur les playlists compatibles identifie les métriques agrégées sur les vidéos et les métriques sur les playlists qui sont compatibles avec les rapports sur les playlists.

• Les nouvelles métriques suivantes relatives aux vidéos dans les playlists sont disponibles pour les rapports sur les playlists des chaînes. Ces métriques ne sont pas encore compatibles avec les rapports de propriétaires de contenu. Notez que ces métriques ne sont compatibles que si la requête API pour récupérer les rapports n'utilise pas la dimension isCurated. Consultez la documentation sur les metrics pour obtenir la définition de chaque métrique:

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

• Le comportement de la métrique views varie désormais selon que la requête API qui récupérait le rapport sur les playlists a utilisé la dimension isCurated ou non:

  • Lorsqu'une requête inclut la dimension isCurated, la métrique views est une métrique dans les playlists qui indique le nombre de fois où des vidéos ont été regardées dans le contexte des playlists de la chaîne.
  • Lorsqu'une demande n'inclut pas la dimension isCurated, la métrique views est une métrique vidéo agrégée qui indique le nombre total de visionnages de la vidéo figurant dans les playlists de la chaîne, que ces vues aient eu lieu ou non dans le contexte de la playlist. Le total cumulé n'inclut que les vues des vidéos appartenant à la chaîne à laquelle la playlist appartient.
    
    Dans ces rapports, qui n'utilisent pas la dimension isCurated, la métrique playlistViews indique le nombre de fois où des vidéos ont été regardées dans le contexte d'une playlist. Cette métrique comptabilise les vues pour toutes les vidéos de la playlist, quelle que soit la chaîne sur laquelle elles sont propriétaires.

• Pour chaque rapport sur les playlists, la documentation sur les rapports sur les canaux inclut désormais des tableaux indiquant les métriques acceptées pour ce rapport, selon que la requête API inclut ou non la dimension isCurated. Pour obtenir un exemple, consultez la section concernant les rapports sur les playlists temporelles.

4 décembre 2023

L'API YouTube Analytics (Targeted Query) a été mise à jour afin de fusionner deux valeurs de dimension insightTrafficSourceType. Auparavant, la dimension différenciait les vidéos lues dans le cadre d'une playlist (PLAYLIST) et les vues provenant d'une page répertoriant toutes les vidéos d'une playlist (YT_PLAYLIST_PAGE). À l'avenir, les deux types de vues seront associés à la valeur de la dimension PLAYLIST.

15 décembre 2022

L'API YouTube Analytics (Requêtes ciblées) accepte deux nouvelles dimensions et un nouveau rapport:

• Un nouveau rapport indique l'activité des utilisateurs par ville. Ce rapport est disponible pour les chaînes et les propriétaires de contenu. Ce rapport contient la nouvelle dimension city, qui identifie l'estimation de YouTube concernant la ville où l'utilisateur a eu lieu.

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

  La dimension creatorContentType est acceptée en tant que dimension facultative pour tous les rapports sur les vidéos des propriétaires de chaîne et de contenu.

• Le guide des exemples de demandes pour 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

Les API YouTube Analytics (requêtes ciblées) et YouTube Reporting (rapports groupés) sont toutes deux compatibles avec une nouvelle valeur de détail des sources de trafic:

• Dans l'API YouTube Analytics (Targeted Query), si la valeur de la dimension insightTrafficSourceType est SUBSCRIBER, la valeur insightTrafficSourceDetail peut être définie sur podcasts. Cela signifie que le trafic provient de la page de destination Podcasts.
• Dans l'API de création de rapports YouTube (rapports groupés), si la valeur de la dimension traffic_source_type est 3, la valeur traffic_source_detail peut être définie sur podcasts. Cela signifie que le trafic provient de la page de destination Podcasts.

11 février 2022

L'ensemble de valeurs valides pour la dimension gender évoluera à partir du 11 août 2022. Il peut s'agir d'une modification rétrocompatible dans la mise en œuvre de votre API. Conformément à la section Modifications incompatibles des conditions d'utilisation des services d'API YouTube, cette modification est annoncée six mois avant son entrée en vigueur. Veuillez mettre à jour l'implémentation de votre API avant le 11 août 2022 pour assurer une transition fluide vers le nouvel ensemble de valeurs.

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

• Dans l'API YouTube Analytics (Requêtes ciblées), 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 YouTube (rapports groupés), la dimension gender accepte actuellement trois valeurs: FEMALE, MALE et GENDER_OTHER. À partir du 11 août 2022, l'ensemble des valeurs acceptées sera FEMALE, MALE et USER_SPECIFIED.

9 février 2022

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

• Dans l'API YouTube Analytics (requêtes ciblées), les métriques averageViewDuration et averageViewPercentage excluent toutes deux le trafic des extraits en boucle depuis le 13 décembre 2021.
• Dans l'API de création de rapports YouTube (rapports groupés), les métriques average_view_duration_seconds et average_view_duration_percentage excluent toutes deux le trafic des extraits en boucle depuis le 13 décembre 2021.

2 février 2022

Cette API de création de rapports YouTube (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 YouTube (rapports groupés), 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 d'où provient le spectateur.

23 septembre 2020

L'API YouTube Analytics (Requêtes ciblées) et l'API YouTube Reporting (Rapports groupés) sont toutes deux compatibles avec une nouvelle valeur de dimension "Source de trafic" qui indique que le spectateur a été redirigé verticalement dans l'expérience de visionnage YouTube Shorts:

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

La dimension "Détails de la source de trafic" (insightTrafficSourceDetail dans l'API YouTube Analytics ou traffic_source_detail dans l'API YouTube Reporting) n'est pas renseignée pour ce nouveau type de source de trafic.

20 juillet 2020

Cette mise à jour concerne deux modifications qui ont une incidence sur l'API YouTube Analytics (requêtes ciblées) :

• 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 identifie la liste des 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. 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 YouTube Reporting (rapports groupés). Pour en savoir plus sur ces modifications, consultez le Centre d'aide YouTube.

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

Les nouvelles valeurs permettent de répartir les notifications liées aux vidéos mises en ligne et aux diffusions en direct (précédemment signalées par uploaded) en deux catégories:

• uploaded_push : nombre de vues provenant de notifications push envoyées aux abonnés lors de la mise en ligne d'une vidéo
• uploaded_other : les vues proviennent de notifications non push (notifications dans la boîte de réception ou par e-mail, par exemple) envoyées aux abonnés lorsqu'une vidéo a été mise en ligne.

Ces valeurs sont renvoyées pour la période commençant le 13/01/2020 (13 janvier 2020).

Pour rappel, ces valeurs ne représentent pas les notifications elles-mêmes, mais plutôt 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, elle indique que trois vues ont été générées par des spectateurs ayant cliqué sur des notifications push envoyées lors de la mise en ligne de la vidéo.

15 octobre 2019

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

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

  YouTube n'acceptera bientôt plus les dimensions 7DayTotals et 30DayTotals. Vous pourrez récupérer les données utilisant ces dimensions jusqu'au 15 avril 2020. À cette date ou après, 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 données pour ces dimensions en effectuant des requêtes à l'aide de la dimension day, et en agrégeant ou en générant les données sur des périodes de 7 ou 30 jours. Exemple :

  • Le nombre de vues sur une période de sept jours peut être calculé en additionnant le nombre de vues enregistrées chaque jour pendant cette période.
  • La valeur "viewerPercentage" sur une période de sept jours peut être calculée en multipliant le nombre de vues quotidiennes par le nombre de personnes qui ont vu la vidéo dans la journée par le nombre de personnes qui ont visionné la vidéo. Ensuite, vous pouvez 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 sur l'ensemble de la période.
  • Impossible de calculer le nombre de spectateurs uniques sur une période de sept jours, car un même spectateur peut être considéré comme un spectateur unique à 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 (requêtes ciblées) :

• La version 1 de l'API étant désormais complètement obsolète, la documentation a été mise à jour pour supprimer les références à cette version, y compris l'avis d'abandon et le guide de migration expliquant comment passer à la version 2.

1er novembre 2018

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

• 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 de l'API dès que possible afin de limiter les interruptions de service. Pour en savoir plus, consultez le guide de migration.

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

17 septembre 2018

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

• 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 de nombreux cas. En pratique, cela signifie qu'un rapport peut ne pas contenir toutes vos données (ou une partie d'entre elles) si:

  1. le trafic d'une vidéo ou d'une chaîne est limité pendant une période donnée,

     ou

  2. vous avez sélectionné un filtre ou une dimension (source de trafic ou pays, par exemple) dont les valeurs n'atteignent pas un certain seuil ;

  Elle aborde également les types de données susceptibles d'ê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 tenir compte du fait que les métriques redViews et estimatedRedMinutesWatched ne sont plus compatibles avec les rapports sur le contexte de lecture, les sources de trafic et les types d'appareils/systèmes d'exploitation.

18 juin 2018

Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Analytics (requêtes ciblées) :

• Les exigences de champ d'application ont changé pour les méthodes suivantes :
  • Les requêtes envoyées à la méthode reports.query doivent avoir accès au champ d'application https://www.googleapis.com/auth/youtube.readonly.
  • Les requêtes envoyées à la méthode groupItems.list doivent avoir accès à :
    • le champ d'application https://www.googleapis.com/auth/youtube
      ou
    • le champ d'application https://www.googleapis.com/auth/youtube.readonly
      et
      le champ d'application https://www.googleapis.com/auth/yt-analytics.readonly

    La première option utilise un champ d'application, qui se trouve être un champ d'application en lecture-écriture, tandis que la deuxième option utilise deux champs d'application en lecture seule.

23 mai 2018

Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Analytics (requêtes ciblées) :

• La vue d'ensemble de l'API contient une nouvelle section, Métriques agrégées et éléments supprimés, qui explique comment les réponses de l'API traitent les données associées aux ressources supprimées, telles que les vidéos, les playlists ou les chaînes.
• La section Bonnes pratiques de la présentation de l'API a été mise à jour pour vous rappeler que vous pouvez utiliser l'API YouTube Data pour récupérer des métadonnées supplémentaires pour des ressources identifiées dans les réponses de l'API YouTube Analytics. Comme indiqué dans les Règles pour les développeurs des services d'API YouTube (sections III.E.4.b à III.E.4.d), les clients API doivent supprimer ou actualiser les métadonnées de ressources stockées de cette API 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 sont actuellement prévues pour juillet 2018. Les nouvelles règles s'appliquent à l'ensemble des rapports et des tâches de création de rapports.

  • Après la modification, la plupart des rapports de l'API, y compris les rapports sur les annonces de remplissage, seront disponibles pendant 60 jours à compter de leur création. Toutefois, les rapports contenant des données historiques sont disponibles pendant 30 jours à compter de leur création.

    Avant cette annonce, tous les rapports de l'API étaient disponibles pendant 180 jours à compter de leur création. Sachez que lorsque cette modification entrera en vigueur, les rapports sur les données historiques datant de plus de 30 jours ne seront plus accessibles via l'API. De plus, tous les autres rapports datant de plus de 60 jours ne seront plus accessibles. La documentation indique désormais que les rapports créés avant le changement des règles sont disponibles jusqu'à 180 jours.

  • Après la modification, lorsque vous planifiez une tâche de création de rapports, YouTube génère des rapports couvrant les 30 jours précédant l'heure prévue de la tâche. Avant la modification, lorsque vous planifiez une tâche de création de rapports, YouTube génère des rapports couvrant la période de 180 jours précédant l'heure à laquelle la tâche a été planifiée.

• La section Bonnes pratiques a été mise à jour pour vous rappeler que vous pouvez utiliser l'API YouTube Data pour récupérer des métadonnées supplémentaires pour les ressources identifiées dans les rapports. Comme indiqué dans les Règles pour les développeurs des services d'API YouTube (sections III.E.4.b à III.E.4.d), les clients API doivent supprimer ou actualiser les métadonnées de ressources stockées de cette API au bout de 30 jours.

• La section Caractéristiques des rapports a été mise à jour pour indiquer que, même si les données de rapport ne sont pas filtrées, les rapports contenant des données pour une période égale ou postérieure au 1er juin 2018 ne contiennent aucune référence à des ressources YouTube supprimées au moins 30 jours avant la date de création du rapport.

• La section des données historiques de la présentation de l'API a été mise à jour pour indiquer que lorsque vous planifiez une nouvelle tâche de création de rapports, les rapports historiques sont généralement publiés au bout de quelques jours. Auparavant, la documentation indiquait qu'il pouvait s'écouler jusqu'à 30 jours avant que ces rapports ne soient disponibles.

• La section Données sur les annonces de remplissage de la présentation de l'API a été mise à jour afin de définir plus clairement les données de remplissage comme un ensemble de données qui remplace un ensemble déjà diffusé.

26 avril 2018

La version 2 de l'API YouTube Analytics (Requêtes ciblées) (version 2) est désormais accessible au public. La liste suivante répertorie les modifications apportées au produit et à la documentation liées à la nouvelle version de l'API:

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

  • La version de l'API est passée de v1 à v2.
  • L'URL de base des requêtes API est passée de https://www.googleapis.com/youtube/analytics/v1 à https://youtubeanalytics.googleapis.com/v2.
  • Des noms ont été modifiés pour plusieurs paramètres de la méthode reports.query. Plus précisément, les noms de paramètres contenant des traits d'union, comme end-date dans la version 1 de l'API, utilisent la casse Camel (endDate) au lieu des traits d'union dans la version 2. Cette modification rend les noms de paramètres cohérents dans toute l'API, car les méthodes de l'API pour la création et la gestion des groupes utilisaient déjà la casse camel pour les noms de paramètres.
  • L'API v2 n'est pas compatible avec les requêtes par lot envoyées au point de terminaison par lot HTTP (www.googleapis.com/batch) global de Google. Si vous envoyez des requêtes par lot avec la version 2, vous devez utiliser le point de terminaison https://youtubeanalytics.googleapis.com/v2 à la place.

  En outre, quelques fonctionnalités de la version 1 ne sont pas compatibles avec la version 2 de l'API:

  • La méthode reports.query n'accepte plus les paramètres de requête alt, quotaUser et userIp.
  • La version 2 de l'API ne fournit pas de point de terminaison de lot compatible avec les lots composés de requêtes adressées à différentes API. Notez qu'un lot peut être constitué de requêtes adressées à différentes méthodes de la même API. Cet abandon n'est pas spécifique à l'API YouTube Analytics, car Google abandonne le point de terminaison mondial des lots pour toutes ses API.
  • La version 2 de l'API n'est pas compatible avec le protocole JSON-RPC, qui était compatible avec la version 1 de l'API. Là encore, cet abandon n'est pas spécifique à l'API YouTube Analytics.

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

  La version 1 de l'API (v1) est désormais obsolète et sera compatible jusqu'au 31 octobre 2018. Après cette date, toutes les requêtes envoyées à l'API v1 cesseront de fonctionner. Veillez donc à passer à la version 2 de l'API au plus tard le 31 octobre 2018 pour éviter toute interruption de votre accès aux données YouTube Analytics via l'API.

21 février 2018

Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Analytics (requêtes ciblées) :

• Les rapports sur les performances démographiques des spectateurs, qui regroupent les statistiques de visionnage en fonction de la tranche d'âge et du genre des spectateurs, n'acceptent plus la dimension youtubeProduct, qui identifie le service YouTube sur lequel l'activité des utilisateurs a eu lieu.

18 janvier 2018

Cette mise à jour inclut les changements suivants :

• API YouTube Reporting (rapports groupés)

  • La dimension operating_system, qui identifie le système logiciel de l'appareil sur lequel les vues ont eu lieu, accepte désormais la valeur suivante :
    • 25: KaiOS

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

  • La dimension operatingSystem accepte la valeur KAIOS.

20 décembre 2017

Cette mise à jour inclut deux modifications apporté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 requise pour chaque réponse de l'API. Par ailleurs, même si la décompression des réponses de l'API nécessite du temps CPU supplémentaire, l'avantage de réduire la consommation des ressources réseau l'emporte généralement sur ce coût.

  Pour recevoir une réponse encodée au format gzip, définissez l'en-tête de requête HTTP Accept-Encoding sur gzip, comme illustré 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 sur les 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 qu'elle ne reflète pas un changement au niveau du fonctionnement ou du comportement de l'API. Plus précisément, les valeurs suivantes ont changé:

  • Les valeurs de la dimension age_group utilisent des lettres majuscules, 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. Par conséquent, des valeurs telles que age13-17 et age18-24 ont été corrigées en AGE_13_17 et AGE_18_24, respectivement.
  • Les valeurs de la dimension gender utilisent des lettres majuscules. Par conséquent, les valeurs female, male et gender_other ont été corrigées en FEMALE, MALE et GENDER_OTHER.

10 août 2017

Le 10 août 2016, cette documentation a annoncé l'abandon de la métrique earnings de l'API YouTube Analytics. Dans le même temps, l'API a ajouté la prise en charge d'une nouvelle métrique, nommée estimatedRevenue, qui fournit les mêmes données.

La métrique earnings étant une métrique essentielle, elle a été acceptée pendant un an à compter de la date de l'annonce. Cette période d'un an étant terminée, la métrique earnings n'est plus acceptée. Par conséquent, les requêtes API qui spécifient la métrique earnings renvoient désormais un code de réponse HTTP 400. Si vous n'avez pas encore mis à jour votre application afin qu'elle utilise la métrique estimatedRevenue au lieu de la métrique earnings, veuillez le faire dès que possible.

La documentation de l'API a été mise à jour pour supprimer les références restantes à la métrique earnings.

6 juillet 2017

Cette mise à jour inclut les changements suivants :

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

  • La documentation de l'API a été mise à jour pour tenir compte du 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 demande spécifie la date de fin le 5 juillet 2017 et que les valeurs de toutes les métriques demandées ne sont disponibles que jusqu'au 3 juillet 2017, ces données seront incluses dans la réponse pour la dernière fois. (Cela est vrai même si les données de certaines métriques demandées sont disponibles pour le 4 juillet 2017.)

  • La dimension adType accepte désormais la valeur reservedBumperInstream, qui désigne une annonce vidéo non désactivable d'une durée maximale de six secondes qui est lue avant qu'une vidéo puisse être visionnée. Le format de l'annonce est identique à celui de l'annonce auctionBumperInstream, mais ce type fait référence aux annonces vendues via un système de réservation plutôt que sur la base d'enchères.

• API YouTube Reporting (rapports groupés)

  • La dimension ad_type accepte désormais la valeur 20, qui fait référence aux annonces bumper vendues via un système de réservations. Les annonces bumper sont des annonces vidéo non désactivables de six secondes maximum qui sont diffusées avant le visionnage d'une vidéo. Notez que la valeur 19 pour cette dimension fait également référence aux annonces bumper vendues via des enchères 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

    Nous avons annoncé l'abandon de ces types de rapports le 15 septembre 2016. Ils n'ont plus été générés après le 15 décembre 2016. Les rapports précédemment générés étaient encore disponibles pendant 180 jours à compter de leur date de création. C'est pourquoi certains rapports sont accessibles depuis le 15 juin 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches qui leur sont associées ne sont pas non plus nécessaires.

24 mai 2017

Toutes les tâches de création de rapports pour les rapports suivants de l'API YouTube Reporting ont été supprimées:

• content_owner_ad_performance_a1
• content_owner_asset_estimated_earnings_a1
• content_owner_estimated_earnings_a1

Nous avons annoncé que ces types de rapports seraient abandonnés le 22 juin 2016. Ils n'ont plus été générés après le 22 septembre 2016. Les rapports précédemment générés étaient encore disponibles pendant 180 jours à compter de leur date de création. Certains rapports sont donc disponibles depuis le 22 mars 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches qui leur sont associées ne sont pas non plus nécessaires.

22 mai 2017

Cette mise à jour inclut les changements suivants :

• API YouTube Reporting (rapports groupés)

  • La dimension sharing_service, qui identifie le service utilisé pour partager des vidéos, accepte désormais les valeurs suivantes:
    • 85: YouTube Music
    • 86: YouTube Gaming
    • 87: YouTube Kids
    • 88: YouTube TV

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

• 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

Désormais, les propriétaires de chaînes qui peuvent accéder aux données sur les revenus via YouTube Analytics dans Creator Studio peuvent désormais y accéder via l'API YouTube Analytics:

• L'API accepte les métriques de revenus suivantes:

  • adImpressions
  • cpm
  • estimatedAdRevenue
  • estimatedRedPartnerRevenue
  • estimatedRevenue
  • grossRevenue
  • monetizedPlaybacks
  • playbackBasedCpm

  Ces métriques sont compatibles avec les rapports suivants:

  • Statistiques de base sur l'activité des utilisateurs
  • Activité des utilisateurs par pays pour des périodes spécifiques
  • Activité des utilisateurs par pays
  • Vidéos les plus regardées avec filtres régionaux facultatifs

• Les propriétaires de chaînes peuvent désormais récupérer un rapport sur les performances des annonces, qui accepte les dimensions adType et day (facultative).

• Le guide des exemples de demandes pour l'API YouTube Analytics inclut désormais une section pour les rapports sur les revenus des chaînes.

17 mars 2017

Cette mise à jour inclut les changements suivants :

• L'API YouTube Analytics accepte les métriques redViews et estimatedRedMinutesWatched, qui concernent le nombre de spectateurs YouTube Red. En fait, l'API prend en charge ces métriques depuis un certain temps, et l'API YouTube Reporting est déjà compatible avec ces deux métriques, comme annoncé le 15 septembre 2016.

  • La métrique redViews indique le nombre de fois qu'une vidéo a été regardée par les membres YouTube Red.
  • La métrique estimatedRedMinutesWatched indique le nombre de minutes pendant lesquelles les membres YouTube Red ont regardé une vidéo.

  La documentation concernant les rapports sur les canaux et les rapports sur les propriétaires de contenu a été mise à jour afin d'indiquer les rapports compatibles avec les deux nouvelles métriques. Elles sont compatibles avec tous les rapports qui acceptaient déjà les métriques views et estimatedMinutesWatched.

3 mars 2017

Cette mise à jour inclut les changements suivants :

• API YouTube Reporting (rapports groupés)

  • La définition de la dimension date a été corrigée afin de noter que la valeur de la dimension fait référence à la période commençant à minuit (heure du Pacifique) et se terminant à 23h59 (heure du Pacifique) le jour, le mois et l'année spécifiés. Selon 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, celles où les horloges sont décalées représentent une période de 23 heures, et celles où le décalage des horloges est rétrogradé représentent une période de 25 heures. (Précédemment, la documentation indiquait que chaque date représentait une période unique de 24 heures et que l'heure du Pacifique correspondait toujours au fuseau UTC-8.)

    Notez que cette correction ne modifie pas le comportement réel de l'API.

  • La dimension operating_system, qui identifie le système logiciel de l'appareil sur lequel les vues ont eu lieu, accepte désormais les valeurs suivantes :
    • 22: Tizen
    • 23: Firefox
    • 24: RealMedia

  • Toutes les tâches de création de rapports pour le type de rapport content_owner_basic_a1 ont été supprimées. Ce type de rapport a été totalement abandonné le 19 août 2016, mais les rapports content_owner_basic_a1 précédemment générés étaient encore disponibles pendant 180 jours à compter de leur création. Par conséquent, certains rapports sont accessibles depuis le 19 février 2017. Toutefois, étant donné que les rapports ne sont plus disponibles, les tâches qui leur sont associées ne sont pas non plus nécessaires.

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

  • La description des dimensions associées à time periods a été corrigée afin de noter que la valeur de la dimension fait référence à la période commençant à minuit (heure du Pacifique) et se terminant à 23h59 (heure du Pacifique) le jour, le mois et l'année spécifiés. Selon 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, celles où les horloges sont décalées représentent une période de 23 heures, et celles où le décalage des horloges est rétrogradé représentent une période de 25 heures. (Précédemment, la documentation indiquait que l'heure du Pacifique était UTC-8 et ne mentionnait pas la possibilité qu'un jour ne représente pas une période de 24 heures.)

    Notez que cette correction ne modifie pas le comportement réel de l'API.

  • La documentation relative aux rapports sur les canaux a été mise à jour pour indiquer que ces rapports n'incluent actuellement ni les revenus, ni les métriques sur les performances des annonces. Par conséquent, le champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly n'accorde actuellement pas l'accès aux données monétaires dans les rapports sur les canaux.

  • La dimension operatingSystem accepte trois nouvelles valeurs :
    • FIREFOX
    • REALMEDIA
    • TIZEN

8 février 2017

L'API YouTube Analytics est désormais compatible avec le paramètre facultatif include-historical-channel-data. Notez que ce paramètre n'est pertinent que pour récupérer des rapports sur les propriétaires 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 et les données sur les vues des chaînes pour la période précédant l'association des chaînes au propriétaire de contenu. La valeur par défaut du paramètre est false, ce qui signifie que, par défaut, la réponse de l'API n'inclut que les données sur la durée de visionnage et les vues pour la période d'association des chaînes au propriétaire de contenu.

Ces règles s'appliquent également si la requête API récupère des données pour plusieurs canaux:

• Si la valeur du paramètre est false, les données sur la durée de visionnage et les vues affichées pour une chaîne donnée sont basées sur la date à laquelle cette chaîne a été associée au propriétaire de contenu.
  
  N'oubliez pas que différentes chaînes peuvent avoir été associées à un propriétaire de contenu à différentes dates. Si la requête API récupère les données de plusieurs chaînes et que la valeur du paramètre est false, la réponse de l'API contient des données sur la durée de visionnage et les vues en fonction de la date d'association pour chaque chaîne.
• Si la valeur du paramètre est true, la réponse renvoie des données sur la durée de visionnage et les vues de tous les canaux en fonction des dates de début et de fin spécifiées dans la requête API.

15 décembre 2016

Les rapports suivants de l'API YouTube Reporting ne sont plus acceptés et ont été supprimés de la documentation. Une version plus récente de chaque rapport est disponible. (L'annonce de l'abandon de ces rapports a été faite le 15 septembre 2016.)

• Rapports sur les canaux

  • channel_basic_a1 : remplacé par le rapport channel_basic_a2.
  • channel_province_a1 : remplacé par le rapport channel_province_a2.
  • channel_playback_location_a1 : remplacé par le rapport channel_playback_location_a2.
  • channel_traffic_source_a1 : remplacé par le rapport channel_traffic_source_a2.
  • channel_device_os_a1 : remplacé par le rapport channel_device_os_a2.
  • channel_subtitles_a1 : remplacé par le rapport channel_subtitles_a2.
  • channel_combined_a1 : remplacé par le rapport channel_combined_a2.

• Rapports du propriétaire de contenu

  • content_owner_basic_a2 : remplacé par le rapport content_owner_basic_a3.
  • content_owner_province_a1 : remplacé par le rapport content_owner_province_a2.
  • content_owner_playback_location_a1 : remplacé par le rapport content_owner_playback_location_a2.
  • content_owner_traffic_source_a1 : remplacé par le rapport content_owner_traffic_source_a2.
  • content_owner_device_os_a1 : remplacé par le rapport content_owner_device_os_a2.
  • content_owner_subtitles_a1 : remplacé par le rapport content_owner_subtitles_a2.
  • content_owner_combined_a1 : remplacé par le rapport content_owner_combined_a2.
  • content_owner_asset_basic_a1 : remplacé par le rapport content_owner_asset_basic_a2.
  • content_owner_asset_province_a1 : remplacé par le rapport content_owner_asset_province_a2.
  • content_owner_asset_playback_location_a1 : remplacé par le rapport content_owner_asset_playback_location_a2.
  • content_owner_asset_traffic_source_a1 : remplacé par le rapport content_owner_asset_traffic_source_a2.
  • content_owner_asset_device_os_a1 : remplacé par le rapport content_owner_asset_device_os_a2.
  • content_owner_asset_combined_a1 : remplacé par le rapport content_owner_asset_combined_a2.

La liste des types de rapports actuels dans la documentation de référence de l'API a également été mise à jour.

11 novembre 2016

Cette mise à jour inclut les changements suivants :

L'API YouTube Reporting est compatible avec trois nouveaux rapports sur les écrans de fin, ainsi que de nouvelles dimensions et métriques pour ces rapports. Les rapports fournissent des statistiques sur les impressions et les clics pour les écrans de fin qui s'affichent après l'arrêt de la lecture d'une vidéo.

• Rapports sur les écrans de fin

  • Le rapport sur les écrans de fin pour les vidéos d'une chaîne contient les statistiques de toutes les vidéos d'une chaîne.
  • Le rapport sur les écrans de fin pour les vidéos de propriétaires de contenu contient des statistiques sur les vidéos des chaînes d'un propriétaire de contenu.
  • Le rapport sur les éléments de propriétaire de contenu contient des statistiques sur les éléments associés aux vidéos, après quoi les écrans de fin s'affichent.

• Dimensions des écrans de fin

  • end_screen_element_type: type d'élément d'écran de fin associé aux statistiques.
  • end_screen_element_id: ID utilisé par YouTube pour identifier de façon unique l'élément d'écran de fin.

• Métriques sur les écrans de fin

  Remarque:Les données sur les métriques des écrans de fin sont disponibles depuis le 1er mai 2016.

  • end_screen_element_impressions: nombre total d'impressions d'éléments d'écran de fin. Une impression est enregistrée pour chaque élément d'écran de fin affiché.
  • end_screen_element_clicks: nombre de fois où les utilisateurs ont cliqué sur des éléments d'écran de fin.
  • end_screen_element_click_rate: taux de clics des éléments d'écran de fin.

Consultez le centre d'aide YouTube pour en savoir plus sur l'ajout d'écrans de fin à vos vidéos.

• Les rapports suivants ne sont plus acceptés et ont été supprimés de la documentation. Une version plus récente de chaque rapport est disponible. (L'annonce de l'abandon de ces rapports a été faite le 22 juin 2016.)

  • content_owner_ad_performance_a1 : remplacé par le rapport content_owner_ad_rates_a1.
  • content_owner_estimated_earnings_a1 : remplacé par le rapport content_owner_estimated_revenue_a1.
  • content_owner_asset_estimated_earnings_a1 : remplacé par le rapport content_owner_asset_estimated_revenue_a1.

8 novembre 2016

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

• Les métriques figurant dans 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 indique les noms des métriques obsolètes et des nouveaux noms:

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

27 octobre 2016

Désormais, YouTube génère 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 des API gérées par le système sont conçus pour fournir un accès programmatique 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 offre une brève présentation des nouveaux rapports et explique comment les récupérer via l'API. Ce processus est légèrement différent de celui utilisé pour récupérer des rapports groupés pour YouTube Analytics, car les partenaires n'ont pas besoin de planifier de 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 et mondiaux par vidéo
• Revenus publicitaires quotidiens et par pays pour chaque vidéo
• Revenus publicitaires mensuels et mondiaux par élément
• Revenus publicitaires quotidiens et par pays par élément
• Revendications (ce rapport ne contient pas de données sur les revenus)

27 septembre 2016

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

La métrique uniques de l'API YouTube Analytics a été abandonnée. Il ne s'agit pas d'une métrique essentielle. Elle sera disponible jusqu'au 31 octobre 2016.

15 septembre 2016

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

• L'API accepte deux nouvelles métriques liées au nombre de spectateurs YouTube Red:

  • red_views: nombre de fois qu'une vidéo a été regardée par les membres YouTube Red.
  • red_watch_time_minutes: nombre de minutes pendant lesquelles les membres YouTube Red ont regardé une vidéo.

• L'API est compatible avec les nouvelles versions de 20 rapports. Toutes les nouvelles versions sont compatibles avec les nouvelles métriques red_views et red_watch_time_minutes.

  Pour chaque rapport, la valeur indiquée dans l'ID du nouveau type de rapport est supérieure d'un chiffre au-dessus de l'ID de l'ancien type. Les anciennes versions de ces rapports sont désormais obsolètes, comme décrit plus loin dans cet historique des révisions. Par exemple, le rapport channel_basic_a1 est désormais obsolète et a été remplacé par le rapport channel_basic_a2.

  Les listes suivantes identifient les ID des nouveaux types de rapports:

  • Rapports sur les vidéos de chaîne

    • channel_basic_a2
    • channel_province_a2
    • channel_playback_location_a2
    • channel_traffic_source_a2
    • channel_device_os_a2
    • channel_subtitles_a2
    • channel_combined_a2

  • Rapports sur les vidéos du propriétaire de contenu

    • content_owner_basic_a3
    • content_owner_province_a2
    • content_owner_playback_location_a2
    • content_owner_traffic_source_a2
    • content_owner_device_os_a2
    • content_owner_subtitles_a2
    • content_owner_combined_a2

  • Rapports sur les composants du propriétaire de contenu

    • content_owner_asset_basic_a2
    • content_owner_asset_province_a2
    • content_owner_asset_playback_location_a2
    • content_owner_asset_traffic_source_a2
    • content_owner_asset_device_os_a2
    • content_owner_asset_combined_a2

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

  Notez que si vous disposez déjà de tâches permettant de créer l'une des anciennes versions des rapports répertoriés ci-dessus, vous devez créer de nouvelles tâches pour les rapports renommés. Parallèlement au lancement des nouvelles versions des rapports, les versions suivantes ont été abandonnées:

  • channel_basic_a1
  • channel_province_a1
  • channel_playback_location_a1
  • channel_traffic_source_a1
  • channel_device_os_a1
  • channel_subtitles_a1
  • channel_combined_a1
  • content_owner_basic_a2
  • content_owner_province_a1
  • content_owner_playback_location_a1
  • content_owner_traffic_source_a1
  • content_owner_device_os_a1
  • content_owner_subtitles_a1
  • content_owner_combined_a1
  • content_owner_asset_basic_a1
  • content_owner_asset_province_a1
  • content_owner_asset_playback_location_a1
  • content_owner_asset_traffic_source_a1
  • content_owner_asset_device_os_a1
  • content_owner_asset_combined_a1

  Si certains de ces rapports contiennent des offres d'emploi, ne vous attendez pas à ce que YouTube génère de nouveaux rapports les concernant après le 15 décembre 2016. Les rapports générés sont toujours disponibles pendant 180 jours à compter de leur création.

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 abandonné et supprimé de la documentation. YouTube ne générera plus de rapports de ce type, mais les rapports déjà générés resteront disponibles pendant 180 jours à compter de leur création.

  Le rapport de content_owner_basic_a1 remplace le rapport 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 ("les Conditions mises à jour"), discutées en détail sur le blog des ingénieurs et des développeurs YouTube, incluent 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 expliquant les règles que les développeurs doivent respecter.

  L'ensemble des nouveaux documents est décrit dans l'historique des révisions des nouvelles Conditions d'utilisation. Par ailleurs, les futures modifications apportées aux Conditions mises à jour ou à ces documents connexes seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS pour répertorier les modifications de cet historique de 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 de l'abandon.

    Les métriques du tableau suivant seront bientôt obsolètes. En parallèle, de nouvelles métriques faisant référence aux mêmes données sont introduites. Dans les faits, cela signifie que les anciennes métriques ont été renommées. Toutefois, l'API YouTube Analytics acceptera les deux noms jusqu'à la date d'abandon indiquée dans le tableau.

    Ancien nom de la métrique	Nom de la nouvelle métrique	Date de prise en charge
    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 acceptée pendant un an à compter de la date de cette annonce. Les autres métriques, qui ne faisaient pas partie des métriques principales, seront compatibles 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. Cependant, après cette date, seule la métrique cpm sera acceptée.

  • La dimension insightTrafficSourceType accepte deux nouvelles valeurs :
    • CAMPAIGN_CARD: cette source de trafic n'est compatible qu'avec les rapports du propriétaire de contenu. Il indique que les vues proviennent de vidéos revendiquées et mises en ligne par des utilisateurs, et utilisées par le propriétaire pour promouvoir les contenus visionnés.
    • END_SCREEN: ces données concernent les vues provenant de l'écran de fin d'une autre vidéo.

    Pour les deux nouvelles sources de trafic, vous pouvez également récupérer un rapport traffic source detail. Dans les deux cas, la dimension insightTrafficSourceDetail identifie la vidéo d'où provient le spectateur.

  • La dimension adType accepte désormais la valeur auctionBumperInstream, qui désigne une annonce vidéo non désactivable d'une durée maximale de six secondes qui est lue avant qu'une vidéo puisse être visionnée.

• API YouTube Reporting (rapports groupés)

  • La dimension traffic_source_type accepte désormais les valeurs suivantes :
    • 19: cette source de trafic n'est compatible qu'avec les rapports du propriétaire de contenu. Il indique que les vues proviennent de vidéos revendiquées et mises en ligne par des utilisateurs, et utilisées par le propriétaire pour promouvoir les contenus visionnés.
    • 20: ces 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 pour inclure estimated_partner_revenue comme métrique principale et supprimer earnings de cette liste. (La métrique earnings n'a jamais été compatible avec 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 de six secondes maximum qui sont lues avant que la vidéo ne puisse être visionnée.

18 juillet 2016

Cette mise à jour inclut les modifications suivantes:

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

  • Les listes des métriques acceptées pour les rapports d'analyse détaillée ci-dessous ont été mises à jour pour inclure les métriques liées aux fiches. Les métriques des fiches sont en fait ajoutées le 28 juin 2016. L'entrée de l'historique des révisions pour cette date explique ce changement plus en détail. Les rapports sont les suivants :
    • Activité de base des utilisateurs dans les États américains
    • Activité des utilisateurs dans les États américains pour des périodes spécifiques
    • Activité des utilisateurs par province
    • Activité des utilisateurs par état d'abonnement
    • Activité des utilisateurs par état d'abonnement pour les provinces
    • Top des vidéos par État
    • Top des vidéos pour les spectateurs abonnés et non abonnés

  • Nous avons corrigé les listes de filtres des rapports sur la rétention d'audience des chaînes et des rapports sur la rétention d'audience des propriétaires de contenu afin de montrer que le filtre video est obligatoire et que le filtre group n'est pas compatible.

    Auparavant, la documentation des deux rapports indiquait à tort qu'ils pouvaient être récupérés à l'aide de l'un de ces deux filtres ou de l'un ou l'autre.

• API YouTube Reporting (rapports groupés)

  • Dans la présentation de l'API, la section expliquant comment récupérer l'URL de téléchargement d'un rapport a été corrigée afin d'indiquer que YouTube génère des rapports téléchargeables pour les jours au cours desquels 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 afin de refléter le fait que le rapport utilise la dimension "card_id". Auparavant, la documentation indiquait à tort card_title comme nom de dimension.

28 juin 2016

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

• cardImpressions
• cardTeaserImpressions
• cardClicks
• cardTeaserClicks
• cardClickRate
• cardTeaserClickRate

Les métriques sont compatibles avec les types de rapports suivants:

• Statistiques de base(chaînes, propriétaires de contenu)
• Basés sur le temps(chaînes, propriétaires de contenu)
• Zone géographique de l'utilisateur (chaînes, propriétaires de contenu)
• Activité des utilisateurs par état d'abonnement (chaînes, propriétaires de contenu)
• Vidéos les plus regardées (chaînes, propriétaires de contenu)

22 juin 2016

Cette mise à jour inclut les modifications suivantes apportées à l'API YouTube Reporting. La première modification concerne l'API en général. Les autres modifications n'affectent que les rapports du propriétaire de contenu:

• La section Caractéristiques des rapports de la présentation de l'API a été mise à jour pour indiquer que les rapports sont disponibles via l'API pendant 180 jours à compter de leur création.

  Auparavant, la documentation indiquait que les rapports étaient disponibles pour une période allant jusqu'à 180 jours avant la date d'envoi de la requête API. Bien que cela soit techniquement vrai, le texte original était, au mieux, plutôt déroutant.

• L'API prend en charge les nouvelles versions de trois rapports. Deux d'entre eux contiennent également de nouvelles métriques qui ont été renommées:

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

  • Deux rapports ayant 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.

    Les deux nouveaux rapports renommés présentent les différences suivantes par rapport à leurs prédécesseurs:

    • Il ajoute la nouvelle métrique estimated_partner_red_revenue, qui permet d'estimer le total des revenus générés par les abonnements YouTube Red.
    • Il ajoute la nouvelle métrique estimated_partner_transaction_revenue, qui estime les revenus issus des transactions, comme les contenus payants et le financement par les fans, moins les remboursements versés par les partenaires.
    • Il renomme la métrique estimated_partner_ad_sense_revenue en estimated_partner_ad_auction_revenue.
    • Il renomme la métrique estimated_partner_double_click_revenue en estimated_partner_ad_reserved_revenue.

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

  Si certains de ces rapports contiennent des offres d'emploi, attendez-vous à ce que YouTube génère de nouveaux rapports les concernant après le 22 septembre 2016. Les rapports générés sont toujours disponibles pendant 180 jours à compter de leur création.

• La définition de la propriété id de la ressource reportType a été mise à jour pour refléter l'ensemble des rapports actuellement disponibles.

• Les noms de deux métriques ont été corrigés dans la documentation pour correspondre aux noms qui apparaissent dans les rapports. Il s'agit simplement d'une correction de la documentation et ne reflète pas un changement dans le contenu réel 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 n'apparaît que dans deux rapports qui seront abandonnés avec cette mise à jour. Comme indiqué 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. Encore une fois, notez que cette métrique n'apparaît que dans deux rapports qui seront abandonnés avec cette mise à jour. Comme indiqué 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 sur les dimensions de l'API Reporting a été mise à jour de manière à ne plus indiquer 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 apportées à 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 type de rapport pour le nouveau rapport est content_owner_basic_a2. Contrairement à la version précédente du rapport (content_owner_basic_a1), la nouvelle version est compatible avec les métriques likes et dislikes.

  Si vous disposez déjà d'une tâche pour créer le rapport content_owner_basic_a1, vous devez tout de même créer une autre tâche pour le rapport content_owner_basic_a2. YouTube ne migre pas automatiquement les propriétaires de contenu vers la nouvelle version du rapport et ne crée pas automatiquement une tâche pour générer la nouvelle version. Dans certaines implémentations, l'apparition d'un nouveau job inattendu peut constituer une modification destructive.

  Parallèlement au lancement du nouveau rapport, le rapport content_owner_basic_a1 est obsolète. Si vous avez une tâche pour ce rapport, ne vous attendez pas à ce que YouTube génère de nouveaux rapports pour cette tâche après le 19 août 2016. Les rapports générés sont toujours disponibles pendant 180 jours à compter de leur création.

• Les ressources reportType, job et report acceptent une nouvelle propriété qui détermine si la ressource associée représente un type de rapport obsolète:

  • La propriété deprecateTime de la ressource reportType indique la date et l'heure auxquelles le type de rapport va être abandonné. Cette propriété n'a une valeur que pour les rapports qui ont été annoncés comme obsolètes. La valeur représente la date à laquelle YouTube ne générera plus de 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, cette mise à jour du 19 mai 2016 annonce l'abandon du rapport content_owner_basic_a1. Ainsi, pour ce type de rapport, deprecateTime indique une heure, au 19 août 2016, après laquelle YouTube ne générera plus de rapports de ce type.

  • La propriété expireTime de la ressource job spécifie la date et l'heure d'expiration du job. Cette propriété est associée à 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 n'ont pas été téléchargés depuis une période prolongée. La date marque l'heure à laquelle YouTube ne génère plus de rapports pour la tâche.

  • La propriété jobExpireTime de la ressource report spécifie la date et l'heure d'expiration ou d'expiration de la tâche 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. En outre, 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 comporte les modifications suivantes, qui ne concernent que l'API YouTube Reporting:

• YouTube génère désormais des données couvrant les 180 jours précédant la planification d'une tâche de création de rapports. Auparavant, l'API Reporting ne fournissait aucune donnée historique. Cette modification affecte toutes les tâches, y compris celles créées avant cette annonce.

  Les rapports historiques sont publiés dès qu'ils sont disponibles, mais il faut environ un mois pour que toutes les données historiques soient publiées pour un travail. Ainsi, un mois après avoir planifié une tâche de création de rapports, vous aurez accès à environ sept mois de données. (Toutes les données historiques des emplois créés avant cette annonce doivent être publiées dans le mois qui suit l'annonce.)

  Notez que les données historiques ne sont disponibles que depuis le 1er juillet 2015. Par conséquent, les emplois créés avant le 28 décembre 2015 disposeront de moins de 180 jours de données historiques.

  Ces modifications sont expliquées dans la nouvelle section Données historiques de la présentation de l'API Reporting.

• La section Caractéristiques du rapport de la vue d'ensemble de l'API YouTube Reporting a été mise à jour avec les modifications suivantes:

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

  • La documentation a été mise à jour pour tenir compte du fait que l'API génère désormais des rapports téléchargeables pour les jours au cours desquels aucune donnée n'était disponible. Ces rapports contiendront 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 propriétaires de contenu ont déjà accès aux rapports sur les revenus téléchargeables manuellement dans Creator Studio sur YouTube. Ainsi, la nouvelle fonctionnalité d'API fournira un accès programmatique à ces données.

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

  • La nouvelle propriété systemManaged de la ressource job indique si cette ressource décrit une tâche générant des rapports gérés par le système. YouTube génère automatiquement des rapports gérés par le système pour les propriétaires de contenu YouTube. Les propriétaires de contenu ne peuvent pas modifier ni supprimer les tâches qui génèrent 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 de ce 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 du rapport datent de la date spécifiée ou sont postérieures à celle-ci. 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 du rapport sont antérieures à la date spécifiée.

    Contrairement au paramètre createdAfter de la méthode, qui se rapporte à l'heure de 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 de ce paramètre est false.

28 mars 2016

Les API YouTube Reporting et YouTube Analytics affichent désormais des statistiques sur les vues pour plusieurs services de partage supplémentaires.

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

16 mars 2016

Cette mise à jour inclut les modifications suivantes, qui concernent à la fois l'API YouTube Reporting et l'API YouTube Analytics:

API YouTube Reporting

• La dimension playback_location_type accepte deux nouvelles valeurs :
  • 7: les données concernent les vues enregistrées sur la page d'accueil ou l'écran d'accueil YouTube, dans le flux "Abonnements" de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.
  • 8: les données concernent les vues enregistrées directement sur la page de résultats de recherche YouTube.
• La dimension traffic_source_type accepte désormais 18 comme valeur de dimension. Cette valeur indique que les vues proviennent d'une page répertoriant l'ensemble des vidéos d'une playlist. Cette source est différente du type de source 14, qui indique que les vues ont eu lieu pendant la lecture de la vidéo dans le cadre d'une playlist.

API YouTube Analytics

• La dimension insightPlaybackLocationType accepte deux nouvelles valeurs :
  • BROWSE: les données concernent les vues enregistrées sur la page d'accueil ou l'écran d'accueil YouTube, dans le flux "Abonnements" de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.
  • SEARCH: les données concernent les vues enregistrées directement sur la page de résultats de recherche YouTube.
• La dimension insightTrafficSourceType accepte désormais YT_PLAYLIST_PAGE comme valeur de dimension. Cette valeur indique que les vues proviennent d'une page répertoriant l'ensemble des vidéos d'une playlist. Cette source est différente du type de source PLAYLIST, qui indique que les vues ont eu lieu pendant la lecture de la vidéo dans le cadre 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 métriques des fiches ne figurent plus parmi les métriques compatibles avec cette API. (Aucun des rapports de cette API n'avait été documenté comme prenant en charge les métriques de la fiche.)

Vous avez toujours la possibilité de récupérer les métriques 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 générées via un Chromecast.

• Dans l'API YouTube Reporting, la dimension operating_system utilise la valeur 21 pour identifier les vues effectuées via Chromecast.
• Dans l'API YouTube Analytics, la dimension operatingSystem utilise la valeur CHROMECAST pour identifier les vues enregistrées 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, ces noms étaient documentés clickable_annotation_impressions et closable_annotation_impressions.

18 décembre 2015

Conformément à la législation de l'Union européenne (UE), les utilisateurs finaux de l'UE doivent divulguer certaines informations et obtenir leur autorisation. Par conséquent, si vous êtes un utilisateur final de l'Union européenne, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE. Nous avons ajouté une notification à ce sujet dans les Conditions d'utilisation de l'API YouTube.

15 décembre 2015

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

• L'API YouTube Analytics est désormais compatible avec trois nouvelles dimensions relatives aux détails de la lecture, que vous pouvez utiliser dans divers rapports de chaîne et de propriétaire de contenu:

  • liveOrOnDemand: cette dimension indique si les données du rapport décrivent l'activité des utilisateurs lors d'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 étaient abonnés à la chaîne de la vidéo ou de la playlist.
  • youtubeProduct: cette dimension identifie la propriété YouTube sur laquelle l'activité de l'utilisateur a eu lieu. Les valeurs possibles incluent le site Web YouTube principal (ou l'application YouTube), YouTube Gaming et YouTube Kids.

  La documentation a été mise à jour afin d'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 pour indiquer 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 les combinaisons valides de dimensions, de métriques et de filtres que vous pouvez utiliser pour récupérer chaque rapport. Le tableau ci-dessous, qui décrit le rapport "Type d'appareil" pour les différents canaux, montre le nouveau format:

  Sommaire
  Dimensions :	Obligatoire deviceType Utilisez 0 ou plus day, liveOrOnDemand, subscribedStatus, youtubeProduct
  Métriques :	Utilisez une ou plusieurs vues et estimatedMinutesWatched
  Filtres :	Indiquez 0 ou 1 pays, province, continent, subContinent Indiquez 0 ou 1 video, group (groupe) Utilisez 0 ou plus operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

• Désormais, l'API YouTube Analytics supprime automatiquement les entités pour lesquelles l'utilisateur de l'API ne peut pas récupérer de données à partir de filtres acceptant 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 est propriétaire de 18 vidéos. Toutefois, un ID vidéo identifie une vidéo appartenant à une autre chaîne, et un autre ID identifie une vidéo qui a été supprimée et, par conséquent, qui n'existe plus. Dans ce cas, au lieu de renvoyer une erreur, le serveur d'API supprime désormais 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 appartenant à l'utilisateur de l'API.

• Si vous demandez des données pour un group YouTube Analytics vide, l'API renvoie désormais un ensemble de données vide au lieu d'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 par la suite, une erreur non autorisée s'affichait lorsque vous tentiez de récupérer des données de rapport pour ce groupe.

• La méthode groups.list de l'API YouTube Analytics accepte désormais 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 :

• L'API YouTube Analytics est désormais compatible avec la métrique redPartnerRevenue, qui indique le total des revenus estimés générés par les abonnements YouTube Red pour les dimensions de rapport sélectionnées. Cette valeur reflète les revenus générés par les contenus musicaux et non musicaux. Elle est sujette à un ajustement en fin de mois.

  La liste des rapports pour les propriétaires de contenu de l'API YouTube Analytics a été mise à jour afin d'identifier les rapports sur les vidéos qui sont compatibles avec la métrique redPartnerRevenue:

  • Statistiques de base
  • Basé sur le temps
  • Zone géographique de l'utilisateur
  • Vidéos les plus regardées : dans ce rapport, la métrique de tri "redPartnerRevenue" est également disponible. Cela signifie que vous pouvez obtenir une liste de vidéos triées en fonction de leurs revenus YouTube Red.

• La définition du rapport Vidéos les plus regardées pour l'API YouTube Analytics indique désormais que ce rapport accepte également les métriques de revenus suivantes: earnings, adEarnings, grossRevenue, monetizedPlaybacks, playbackBasedCpm, impressions et impressionBasedCpm.

29 octobre 2015

Cette mise à jour inclut les changements suivants :

• La documentation concernant la dimension date de l'API YouTube Reporting a été corrigée afin de refléter le fait que les dates font référence à la période de 24 heures commençant à minuit, heure du Pacifique (UTC-8). Auparavant, la documentation indiquait que la date commençait à minuit (GMT).

  De plus, la documentation de l'API YouTube Analytics a été mise à jour pour indiquer que toutes les dimensions liées à la date (day, 7DayTotals, 30DayTotals et month) font référence à des dates commençant à minuit (UTC-8).

• La méthode jobs.reports.list() de l'API YouTube Reporting est désormais compatible avec 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 remplies. Notez que la valeur du paramètre correspond à l'heure 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 pour expliquer comment utiliser le paramètre createdAfter afin d'éviter de traiter un même rapport à plusieurs reprises.

• Les définitions de la propriété createTime de la ressource job et les propriétés startTime, endTime et createTime de la ressource report ont toutes été corrigées pour noter que les valeurs des propriétés sont précises en microsecondes, et non en nanosecondes. De plus, toutes les définitions indiquent désormais avec précision que la valeur de la propriété est un code temporel.

8 octobre 2015

Cette mise à jour inclut les changements suivants :

• La documentation concernant la dimension sharingService de l'API YouTube Analytics a été mise à jour pour inclure une liste des valeurs possibles. La liste comprend un certain nombre de nouveaux services compatibles.

  La définition de la dimension sharing_service de l'API YouTube Reporting a également été mise à jour 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 YouTube Reporting permet de récupérer des rapports groupés contenant des données YouTube Analytics pour 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 est associée à une combinaison unique de valeurs de dimension. Vous pouvez agréger les données des lignes en fonction des valeurs des dimensions afin de calculer des métriques pour des vidéos, pays, vidéos en direct, 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é une mission, YouTube génère un rapport quotidien qui peut être téléchargé de manière asynchrone. Chaque rapport contient des données pour une période unique de 24 heures.

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

  • L'onglet Guides de 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 YouTube Reporting.
  • L'onglet Requêtes ciblées contient une documentation de référence et d'autres contenus spécifiquement destinés à l'API YouTube Analytics.
  • L'onglet Exemples répertorie les exemples de code disponibles pour l'une des deux API.
  • L'onglet Outils répertorie des ressources supplémentaires 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 de manière à en faciliter la compréhension. Par conséquent, ces modifications ne décrivent pas les nouvelles fonctionnalités:

  • Elle comprend désormais une page répertoriant tous les rapports de chaîne disponibles et une autre répertoriant tous les rapports de propriétaire de contenu disponibles. Auparavant, la documentation comportait des pages distinctes pour les rapports sur les vidéos de chaîne, les rapports sur les playlists de chaînes, etc.

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

22 juillet 2015

Cette mise à jour comporte plusieurs modifications, qui ne concernent que les propriétaires de contenu:

• La nouvelle métrique adEarnings inclut le total des revenus estimés (revenus nets) de toutes les sources d'annonces vendues par Google. Il ne s'agit pas d'une métrique essentielle. L'API est compatible avec la métrique adEarnings pour tous les rapports qui acceptent déjà la métrique earnings.

  En outre, la définition de la métrique earnings a été corrigée pour tenir compte du fait que sa valeur inclut le total des revenus estimés provenant de toutes les sources publicitaires vendues par Google et de sources non publicitaires. Auparavant, la définition indiquait à tort que la métrique n'incluait que les revenus provenant de sources publicitaires.

• La métrique primaryAdGrossRevenue a été abandonnée. Utilisez plutôt la métrique grossRevenue pour récupérer les données sur les revenus.

• Outre 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 les acceptent toujours.

1er juin 2015

Cette mise à jour inclut les changements suivants :

• L'API est désormais compatible avec deux nouvelles métriques pour les rapports sur les vidéos : videosAddedToPlaylists et videosRemovedFromPlaylists. Les listes des rapports sur les vidéos pour les chaînes et les propriétaires de contenu ont été mises à jour afin d'identifier les rapports compatibles avec les nouvelles métriques.

  • videosAddedToPlaylists : nombre de fois où des vidéos concernées par la requête ont été ajoutées à des playlists YouTube. Les vidéos peuvent avoir été ajoutées à des playlists de leur propriétaire ou d'autres chaînes.
  • videosRemovedFromPlaylists : nombre de fois où les vidéos concernées par la requête ont été supprimées de l'ensemble des playlists YouTube. Elles peuvent avoir été supprimées de la playlist de leur propriétaire ou de celles d'autres chaînes.

  Ces deux métriques incluent les playlists par défaut, comme la playlist "À regarder plus tard". Toutefois, elles ne comptabilisent pas les playlists auxquelles une vidéo est ajoutée automatiquement, comme la playlist de mises en ligne d'une chaîne ou l'historique des vidéos regardées d'un utilisateur. Notez également que ces métriques reflètent le nombre absolu d'ajouts et de suppressions. Ainsi, si un utilisateur ajoute une vidéo à une playlist, la supprime, puis l'ajoute de nouveau, les métriques indiquent que la vidéo a été ajoutée à deux playlists, puis supprimée d'une playlist.

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

31 mars 2015

Cette mise à jour inclut les changements suivants :

• Les métriques favoritesAdded et favoritesRemoved sont toutes deux obsolètes à compter de cette annonce. Il s'agit de métriques clés et soumises au règlement relatif aux abandons défini dans les Conditions d'utilisation.

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). S'il 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 en fonction des taux de change qui changent quotidiennement.

  La valeur du paramètre est un code de devise ISO 4217 à trois lettres. La valeur par défaut est USD. La définition du paramètre contient une liste de codes de devise acceptés.

25 février 2015

Cette mise à jour inclut les changements suivants :

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

  • Créer et gérer des groupes

    Cette mise à jour présente les ressources group et groupItem permettant de créer et de gérer des groupes.

    • La ressource group représente un groupe Analytics, une collection personnalisée rassemblant un maximum de 200 chaînes, vidéos, playlists ou éléments. L'API est compatible avec 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 est compatible avec les méthodes list, insert et delete pour cette ressource.

    Ainsi, 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 pour un groupe

    La documentation sur les dimensions a été mise à jour pour inclure la dimension group, qui peut servir de filtre pour de nombreux rapports sur les canaux 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 qu'actuellement, l'API ne permet pas de créer des rapports pour les groupes d'assets.

  Consultez le Centre d'aide YouTube pour en savoir plus sur les groupes YouTube Analytics.

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 ces dimensions sont utilisées en tant que filtres. Pour spécifier plusieurs valeurs, définissez la valeur du paramètre filters sur une liste d'ID de vidéos, de playlists, de chaînes ou d'émissions séparés par une virgule 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 demande. Ce principe s'applique même si le filtre n'est pas listé comme dimension acceptée pour un rapport particulier. 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 :

• Lors de la récupération d'un rapport sur les canaux, vous pouvez désormais récupérer des données pour le 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 des vidéos associées à 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 acceptent aussi la métrique averageViewDuration.

  De plus, tous les rapports sur les playlists prennent en charge les nouvelles métriques ci-dessous. Notez que chacune de ces métriques ne reflète que les vues de la playlist sur le Web.

  • playlistStarts: nombre de fois où des internautes ont lancé la lecture d'une playlist.
  • viewsPerPlaylistStart: nombre moyen de vues de vidéos à chaque lancement d'une playlist.
  • averageTimeInPlaylist: estimation de la durée moyenne, en minutes, pendant laquelle un spectateur a regardé des vidéos d'une playlist après le lancement de celle-ci.

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

• L'API est désormais compatible avec le 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 valeurs de métriques correspondantes:

  • La métrique audienceWatchRatio identifie le nombre absolu de spectateurs qui regardent la vidéo à un moment donné de la vidéo. Ce ratio est calculé en comparant le nombre de fois où une partie d'une vidéo a été visionnée et le nombre total de vues de la vidéo.

    Sachez qu'une partie d'une vidéo peut être regardée plusieurs fois (voire pas du tout) au cours d'une même vue. Par exemple, si un utilisateur revient en arrière et regarde plusieurs fois la même partie d'une vidéo, le rapport absolu pour cette partie de la vidéo peut être supérieur à 1.

  • La métrique relativeRetentionPerformance 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. La valeur 0 indique que la vidéo fidélise les spectateurs moins bien que toute autre vidéo de durée similaire, tandis que la valeur 1 indique que la vidéo retient mieux les internautes que toute autre vidéo de durée similaire. Une valeur médiane de 0,5 indique que la moitié des vidéos de durée similaire retiennent mieux les spectateurs, tandis que la moitié les fidélise moins.

  Vous pouvez également utiliser le filtre audienceType pour que le rapport n'affiche que les données associées aux vues naturelles, aux vues 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, comme la recherche d'une vidéo ou un clic sur une suggestion de vidéo.

• L'API prend en charge plusieurs nouvelles métriques liées aux annotations. Les métriques listées ci-dessous peuvent être récupérées avec tous les rapports qui acceptaient auparavant les métriques annotationClickThroughRate et annotationCloseRate.

  • annotationImpressions: nombre total d'impressions d'annotations.
  • annotationClickableImpressions: le nombre d'annotations qui sont apparues et sur lesquelles l'utilisateur peut cliquer.
  • annotationClosableImpressions: le nombre d'annotations qui sont apparues et ont pu être fermées.
  • annotationClicks: nombre total d'annotations sur lesquelles l'utilisateur a cliqué
  • annotationCloses: nombre total d'annotations fermées.

  Toutes les nouvelles métriques sont des métriques clés et sont soumises au Règlement relatif aux abandons. Notez toutefois que ces données sont disponibles depuis le 16 juillet 2013. Les données des statistiques annotationClickThroughRate et annotationCloseRate sont disponibles depuis le 10 juin 2012.

• GOOGLE_SEARCH n'est plus enregistré en tant que valeur distincte pour la dimension insightTrafficSourceType. À la place, les sites référents provenant 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 :

• Le document Rapports sur les propriétaires de contenu a été mis à jour pour indiquer que les métriques subscribersGained et subscribersLost peuvent désormais être récupérées pour le contenu revendiqué ou importé par un propriétaire de contenu.

  La modification est visible dans le premier rapport Statistiques de base pour les propriétaires de contenu, qui accepte désormais les filtres claimedStatus et uploaderType.

16 janvier 2014

Cette mise à jour inclut les changements suivants :

• Le document sur les exemples de demandes a été repensé pour regrouper les exemples par catégories, dans un format d'onglet semblable à celui récemment publié pour les rapports sur les chaînes et les propriétaires de contenu. Dans la nouvelle interface, les exemples sont regroupés dans les catégories suivantes:

  • Statistiques de base
  • Basés sur le temps
  • Ciblage géographique
  • Contexte de lecture
  • Source de trafic
  • Appareil/OS
  • Demographic (Catégorie démographique)
  • Réseau social
  • Revenus/annonces (uniquement pour les rapports des propriétaires de contenu)

• Le document Exemples de demandes comprend désormais de nouveaux exemples permettant de récupérer des données spécifiques à une province dans les rapports sur les canaux ou sur les propriétaires de contenu.

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

  • Données démographiques sur les spectateurs en Californie (tranche d'âge et genre): ce rapport fournit des statistiques sur la tranche d'âge et le genre des spectateurs californiens qui ont regardé les vidéos d'une chaîne ou, pour les rapports des propriétaires de contenu, des contenus revendiqués par un propriétaire de contenu. Cet exemple utilise le paramètre filters pour garantir que la réponse n'inclut que les données d'une province particulière.

• 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 demande doit également limiter 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 listant tous les rapports possibles, chaque document regroupe les rapports en catégories:

  • Statistiques de base
  • Basés sur le temps
  • Ciblage géographique
  • Contexte de lecture
  • Source de trafic
  • Appareil/OS
  • Demographic (Catégorie démographique)
  • Réseau social
  • Vidéos les plus regardées

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

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

  • La dimension province vous permet de récupérer des statistiques pour les États américains et pour le district de Colombie. L'API accepte deux utilisations de cette dimension:

    • L'API prend en charge deux rapports qui détaillent les statistiques État par état. Ces deux rapports sont disponibles pour les chaînes et les propriétaires de contenu.

      • Le rapport sur les statistiques clés comprend plusieurs statistiques, y compris le nombre de vues et l'estimation du nombre de minutes regardées.
      • Le rapport basé sur le temps fournit les mêmes statistiques, mais regroupe les données sur une base quotidienne, 7 jours, 30 jours ou mensuelle.

    • Vous pouvez utiliser le paramètre de requête filters pour limiter un rapport aux statistiques d'un état particulier. Plusieurs rapports sont compatibles avec ce type de filtrage, y compris les rapports sur les zones géographiques, les rapports sur les contextes de lecture, les rapports sur les sources de trafic, les rapports sur les appareils, les systèmes d'exploitation, les données démographiques et les vidéos les plus regardées.

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

  • La dimension subContinent spécifie un code de région statistique des Nations Unies (ONU) qui identifie une sous-région d'un continent. De plus, cette dimension ne peut être utilisée qu'en tant que filtre.

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

• La documentation a été corrigée afin que la dimension insightTrafficSourceDetail n'inclue pas la valeur insightTrafficSourceType PROMOTED comme valeur de filtre valide.

30 septembre 2013

Cette mise à jour inclut les changements suivants :

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

• L'API accepte désormais EXTERNAL_APP en tant que valeur pour la dimension insightPlaybackLocationType. Parallèlement à cette mise à jour, depuis le 10 septembre 2013, les lectures ne sont plus classées dans la catégorie MOBILE, mais les lectures sur mobile antérieures à cette date seront toujours classées avec cette valeur.

  Avec cette mise à jour, les lectures sur mobile sont classées comme des lectures WATCH, EMBEDDED ou EXTERNAL_APP, en fonction du type d'application où elles ont lieu.

• L'API accepte désormais PLAYLIST en tant que valeur pour la dimension insightTrafficSourceType. La valeur indique que les vues de la vidéo proviennent d'une playlist. Auparavant, ces vues étaient 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 de requêtes contient un nouvel exemple, Trier des requêtes en fonction de plusieurs dimensions/métriques, qui illustre cette fonctionnalité. La requête récupère les données sur la source de trafic, et la valeur du paramètre sort est day,-views. Les résultats sont triés par ordre chronologique, mais dans l'ensemble de résultats pour chaque jour, la première ligne contient les données sur la source de trafic qui a généré le plus de vues, la deuxième ligne contient les données pour la source ayant généré le plus grand nombre de vues, et ainsi de suite.

• L'API est désormais compatible avec deux nouvelles dimensions, deviceType et operatingSystem, qui permettent de récupérer des données sur les appareils sur lesquels les spectateurs regardent vos vidéos. L'API est compatible avec les rapports qui utilisent l'une ou l'autre de ces 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 que le rapport sur le type d'appareil ne contienne que les statistiques des appareils exécutant un système d'exploitation spécifique, tel que Android ou iOS.

  • Le rapport operatingSystem vous permet de récupérer le nombre de vues et la durée de visionnage estimée pour différents systèmes d'exploitation (Android, iOS, Linux, etc.). Vous pouvez également utiliser le filtre deviceType pour que le rapport sur le système d'exploitation ne contienne que les statistiques correspondant à un type d'appareil spécifique, comme les appareils mobiles ou les tablettes.

  Les nouveaux rapports sur le type d'appareil et le système d'exploitation sont disponibles pour les chaînes et les propriétaires de contenu.

• Le document sur les exemples de demandes a été mis à jour et inclut désormais 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 de ses autres valeurs.

23 mai 2013

Cette mise à jour inclut les changements suivants :

• Le document Rapports sur les propriétaires de contenu a été mis à jour pour indiquer que vous pouvez trier le rapport sur les vidéos les plus regardées par ordre décroissant des revenus pour identifier les vidéos les plus rémunératrices. Ce rapport est le premier à figurer dans le deuxième tableau de la section Rapports sur l'activité des utilisateurs et sur les revenus.

10 mai 2013

Cette mise à jour inclut les changements suivants :

• YouTube n'identifie plus les fonctionnalités et services d'API expérimentaux. À la place, nous fournissons désormais une liste des API YouTube soumises au règlement relatif aux abandons.

6 mai 2013

Cette mise à jour inclut les changements suivants :

• L'API vous permet désormais de récupérer les métriques sur la durée de visionnage (estimatedMinutesWatched, averageViewDuration et averageViewPercentage) en plus d'autres métriques, comme les métriques sur les vues, l'engagement, les revenus et les performances des annonces.

  Les listes des rapports de chaîne et des rapports pour les propriétaires de contenu disponibles ont été mises à jour pour refléter ce changement. Les listes sont désormais plus courtes, car les métriques sur la durée de visionnage peuvent être récupérées avec d'autres rapports répertoriés.

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

• Les rapports qui utilisent les dimensions insightPlaybackLocationDetail et insightTrafficSourceDetail ont été améliorés comme suit:

  • Elles sont désormais compatibles avec un filtre country facultatif.

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

    • Informations sur le contexte de lecture

      • channel,insightPlaybackLocationType==EMBEDDED
      • show,insightPlaybackLocationType==EMBEDDED
      • claimedStatus,insightPlaybackLocationType==EMBEDDED
      • uploaderType,insightPlaybackLocationType==EMBEDDED
      • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

    • Informations sur la source de trafic

      • channel,insightTrafficSourceType
      • show,insightTrafficSourceType
      • claimedStatus,insightTrafficSourceType
      • uploaderType,insightTrafficSourceType
      • uploaderType,claimedStatus,insightTrafficSourceType

3 mai 2013

Cette mise à jour inclut les changements suivants :

• Le nouveau document Exemples de requêtes API fournit des exemples qui montrent comment extraire de nombreux types de rapports différents à l'aide de YouTube Analytics API. Chaque exemple inclut une brève description du rapport récupéré par la demande, puis affiche les dimensions, les métriques, les filtres et les paramètres de tri de la demande.

• La dimension insightTrafficSourceType accepte désormais SUBSCRIBER comme valeur valide. Cette valeur identifie les vues de vidéos générées par des flux sur la page d'accueil YouTube ou par des fonctionnalités d'abonnement YouTube. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail indique le flux de la page d'accueil ou une autre page d'où proviennent les vues.

28 mars 2013

Cette mise à jour inclut les changements suivants :

• L'API est désormais compatible avec deux nouvelles métriques, annotationClickThroughRate et annotationCloseRate, qui concernent les interactions des spectateurs avec les annotations qui s'affichent pendant vos vidéos. Les listes des rapports de chaîne et des rapports pour les propriétaires de contenu ont été mises à jour afin d'identifier les rapports compatibles avec les nouvelles métriques.

  • annotationClickThroughRate : ratio entre les annotations sur lesquelles les spectateurs ont cliqué et le nombre total d'impressions d'annotations cliquables.
  • annotationCloseRate : ratio entre les annotations que les spectateurs ont fermées et le nombre total d'impressions d'annotations.

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 de nouveaux rapports sur les performances des annonces. Seuls les partenaires de contenu YouTube qui participent au Programme Partenaire YouTube peuvent accéder aux statistiques et aux rapports.

  • Ces nouveaux rapports prennent en charge les métriques de performances des annonces basées sur les lectures et celles basées sur les impressions. Pour en savoir plus sur les rapports sur les performances des annonces, consultez la documentation concernant les rapports du propriétaire de contenu.

  • Les nouvelles métriques compatibles sont listées ci-dessous. La liste des rapports du propriétaire de contenu a été mise à jour afin d'identifier les rapports, y compris les deux nouveaux rapports, qui acceptent ces métriques.

    • earnings : total des revenus estimés de toutes les sources publicitaires vendues par Google
    • grossRevenue : revenus bruts estimés provenant de partenaires Google ou DoubleClick
    • primaryAdGrossRevenue : revenus bruts estimés provenant de Google ou de partenaires DoubleClick, additionnés et classés sous le type d'annonce principal pour les lectures de vidéos couvertes par le rapport.
    • monetizedPlaybacks : nombre de lectures ayant entraîné au moins une impression d'annonce.
    • playbackBasedCpm : revenus bruts estimés pour mille lectures
    • impressions : nombre d'impressions d'annonces validées diffusées.
    • impressionBasedCpm : revenus bruts estimés pour mille impressions d'annonces

    Remarque:Pour en savoir plus, consultez les définitions des métriques.

  • Toute demande qui récupère des métriques sur les revenus ou les performances des annonces doit envoyer un jeton d'autorisation accordant l'accès en utilisant le nouveau champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

• La documentation de l'API a été réorganisée afin que les différents types de rapports soient expliqués sur des pages distinctes. C'est pourquoi nous avons ajouté des pages distinctes expliquant les différents types de rapports de chaîne et de rapports pour les 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 désormais une section Exemples 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 le même que celui qui est décrit en détail 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 API et de récupérer des données réelles dans la réponse.

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

  • Le rapport sur les contextes de lecture indique le nombre de vues de vidéos sur différents types de pages ou d'applications.

  • Le rapport détaillé sur les contextes de lecture identifie les lecteurs intégrés ayant généré le plus de vues pour une vidéo spécifiée. Il offre un affichage plus détaillé que le rapport sur les contextes de lecture, car il identifie les URL associées aux principaux lecteurs intégrés.

  • Le rapport sur les sources de trafic identifie le nombre de vues de vidéos générées par différents types d'URL de provenance.

  • Le rapport détaillé sur les sources de trafic identifie les URL de provenance ayant généré le plus de vues pour une vidéo et un type de source de trafic donnés. Par exemple, ce rapport peut vous présenter les vidéos similaires qui ont généré le plus de trafic vers une vidéo spécifique. Ce rapport est compatible avec plusieurs sources de trafic.

  • Les rapports sur la durée de visionnage indiquent le temps que les spectateurs ont passé à regarder vos contenus. Les rapports peuvent regrouper les données d'une période spécifique (jour, sept jours précédents, 30 jours précédents, etc.) ou d'un pays. Si un rapport cumule les données par jour ou par pays, il peut également indiquer la durée moyenne de chaque visionnage, ainsi que le pourcentage moyen de chaque vidéo visionnée par les internautes.

2 octobre 2012

Cette mise à jour inclut les changements suivants :

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

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

12 septembre 2012

Cette mise à jour inclut les changements suivants :

• La nouvelle section Comprendre l'utilisation des quotas fournit des consignes pour optimiser votre utilisation des quotas d'API. Le serveur d'API calcule un coût pour chaque requête. Ce coût est déduit de votre quota d'utilisation de l'API. Étant donné que les différents types de rapports peuvent générer des coûts de requête très différents, vous devez planifier une utilisation efficace de 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 qu'elles indiquent qu'un rapport Analytics doit regrouper les données en fonction d'une période donnée. L'API accepte désormais les dimensions temporelles supplémentaires suivantes:

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

  De même, la section Rapports disponibles a été mise à jour pour refléter la compatibilité de l'API avec les rapports utilisant ces dimensions.

• La section Dimensions des entités de rapport a été mise à jour pour indiquer que les requêtes API permettant de récupérer des rapports sur les propriétaires de contenu doivent filtrer les données à l'aide de l'une de ces dimensions (video, channel ou show) ou d'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, qui sont disponibles sous la forme de rapports sur les chaînes ou de propriétaires de contenu, affichent les métriques (vues, commentaires, "J'aime", etc.) par pays et les ventilent 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 s'en sont désabonnés, à partir de la page de lecture de la vidéo.

• Les définitions des metrics 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 qui s'affiche sur la page d'accueil YouTube. Lorsque ces métriques apparaissent dans un rapport spécifique à une vidéo, elles n'incluent que celles issues de la page de lecture de la vidéo en question.