Historique des révisions

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

6 mai 2024

L'API YouTube Analytics (Requêtes ciblées) est compatible avec trois nouveaux rapports pour les chaînes:

De plus, la section Audience Le rapport sur la fidélisation a été amélioré et inclut désormais trois nouvelles métriques:

7 avril 2024

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

L'entrée suivante de l'historique des révisions fournit quasiment les mêmes informations que celle du 19 janvier 2024. Notez toutefois que le propriétaire du contenu les rapports sur les playlists sont compatibles isCurated dimension jusqu'au La dimension sera disponible dans les rapports sur les playlists de chaînes jusqu'au 31 décembre 2024. 30 juin 2024.

  • Remarque:Le présent message est une annonce d'abandon.

    isCurated Abandon de la variable dans les rapports sur les playlists de propriétaires de contenu Il ne sera plus disponibles à 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 isCurated , vous devez aussi mettre à jour votre code pour récupérer la métrique playlistViews au lieu de la métrique views pour les rapports sur les playlists uniquement. Depuis le views est toujours acceptée pour les rapports sur les playlists, mais avec une signification différente, l'API mais elle renverra 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 views et playlistViews.

    En plus de la dimension isCurated, les fonctionnalités d'API suivantes sont ne sont plus prises en charge dans les nouveaux rapports:

    • Les filtres de lieu, comme continent et subcontinent, ne sont pas disponibles dans les nouveaux rapports sur les playlists de chaînes.
    • Les métriques redViews et estimatedRedMinutesWatched ne sont plus disponibles dans les nouveaux rapports sur les playlists de chaînes. Ces métriques n'étaient pas disponibles dans YouTube Studio. Les fonctionnalités de l'API seront donc alignées avec celles disponibles dans l'application Studio.
    • Les dimensions subscribedStatus et youtubeProduct ne sont plus comme filtres dans les rapports sur les playlists de chaînes. Ces filtres n'étaient pas disponibles dans YouTube Studio. Ce changement a donc pour objectif d'aligner les fonctionnalités de l'API sur celles disponibles dans l'application Studio.

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

    • Métriques agrégées sur les vidéos fournissent des statistiques sur l'activité des utilisateurs et les impressions, regroupées pour toutes les vidéos de l' playlists du propriétaire de contenu qui lui appartiennent également Les métriques agrégées sur les vidéos sont les suivantes : n'est compatible qu'avec les requêtes API qui n'utilisent pas la dimension isCurated.
    • Métriques dans les playlists reflètent l'activité et l'engagement des utilisateurs dans le contexte de la page de la playlist ; Ces métriques inclure les données pour inclut également les vues des vidéos dont vous n'êtes pas le propriétaire dans la playlist, mais que lorsque ces vues ont été enregistrées dans le contexte de la playlist.
    • Métriques sur les playlists acceptées identifie les métriques agrégées sur les vidéos et les métriques dans les playlists dans les rapports sur les playlists.

  • Les nouvelles métriques Dans une playlist suivantes sont disponibles dans les rapports sur les playlists pour : propriétaires de contenu. Notez que ces métriques ne sont acceptées que si la requête API de récupération les rapports n'utilisent pas la dimension isCurated. Consultez le metrics pour des définitions de chaque métrique:

  • Comportement de views varie désormais selon que la demande API qui a récupéré le rapport sur les playlists a utilisé ou non Dimension isCurated:

    • Lorsqu'une requête inclut la dimension isCurated, La métrique "views" est intégrée à une playlist qui indique le nombre de fois où des vidéos ont été regardées dans le contexte du aux playlists du propriétaire du contenu.
    • Lorsqu'une requête n'inclut pas la dimension isCurated, la La métrique views est une métrique vidéo agrégée qui spécifie le nombre total de visionnages des vidéos des playlists du propriétaire du contenu, que ces ont été enregistrées dans le contexte d'une playlist. Le total cumulé ne comprend que les vues de vidéos appartenant au propriétaire de contenu associé à la chaîne à laquelle appartient la playlist

      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. Elle comptabilise les vues de toutes les vidéos de la playlist, quelle que soit la chaîne qui les possède.

  • Pour chaque rapport sur les playlists, le paramètre rapports sur les propriétaires de contenu la documentation inclut désormais des tableaux indiquant les métriques acceptées pour ce rapport en fonction si la requête API inclut la dimension isCurated. Reportez-vous à la section définissant rapports sur les playlists basées sur la durée à titre d'exemple.

19 janvier 2024

L'API YouTube Analytics (Requêtes ciblées) comporte plusieurs modifications concernant la playlist de chaîne rapports. Ces mises à jour incluent une dimension obsolète, ainsi que plusieurs métriques nouvelles et mises à jour:

  • Remarque:Le présent message est une annonce d'abandon.

    isCurated pour les rapports sur les canaux. Elle ne sera plus prise en charge le ou après le 30 juin 2024. La définition de cette dimension a été mise à jour en conséquence.

    Pour préserver la rétrocompatibilité lorsque vous supprimez isCurated , vous devez aussi mettre à jour votre code pour récupérer la métrique playlistViews au lieu de la métrique views pour les rapports sur les playlists uniquement. Depuis le views est toujours acceptée pour les rapports sur les playlists, mais avec une signification différente, l'API mais elle renverra 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 views et playlistViews.

    En plus de la dimension isCurated, les fonctionnalités d'API suivantes sont ne sont plus prises en charge dans les nouveaux rapports:

    • Les filtres de lieu, comme continent et subcontinent, ne sont pas disponibles dans les nouveaux rapports sur les playlists de chaînes.
    • Les métriques redViews et estimatedRedMinutesWatched ne sont plus disponibles dans les nouveaux rapports sur les playlists de chaînes. Ces métriques n'étaient pas disponibles dans YouTube Studio. Les fonctionnalités de l'API seront donc alignées avec celles disponibles dans l'application Studio.
    • Les dimensions subscribedStatus et youtubeProduct ne sont plus comme filtres dans les rapports sur les playlists de chaînes. Ces filtres n'étaient pas disponibles dans YouTube Studio. Ce changement a donc pour objectif d'aligner les fonctionnalités de l'API sur celles disponibles dans l'application Studio.

  • Les rapports sur les playlists de la documentation concernant les rapports de chaîne a été mise à jour pour expliquer plus en détail Voici les types de métriques compatibles avec les rapports sur les playlists:

    • Métriques agrégées sur les vidéos fournissent des statistiques sur l'activité des utilisateurs et les impressions, regroupées pour toutes les vidéos de l' et accéder aux playlists de cette chaîne. Les métriques agrégées sur les vidéos sont les suivantes : n'est compatible qu'avec les requêtes API qui n'utilisent pas la dimension isCurated.
    • Métriques dans les playlists reflètent l'activité et l'engagement des utilisateurs dans le contexte de la page de la playlist ; Ces métriques inclure les données pour inclut également les vues des vidéos dont vous n'êtes pas le propriétaire dans la playlist, mais que lorsque ces vues ont été enregistrées dans le contexte de la playlist.
    • Métriques sur les playlists acceptées identifie les métriques agrégées sur les vidéos et les métriques dans les playlists dans les rapports sur les playlists.

  • Les nouvelles métriques Dans les playlists suivantes sont disponibles dans les rapports sur les playlists des chaînes. Ces métriques ne sont pas encore disponibles pour les rapports sur les propriétaires de contenu. Notez que ces métriques sont n'est disponible que si la demande API de récupération des rapports n'utilise pas la méthode isCurated. Consultez le metrics pour des définitions de chaque métrique:

  • Comportement de views varie désormais selon que la demande API qui a récupéré le rapport sur les playlists a utilisé ou non Dimension isCurated:

    • Lorsqu'une requête inclut la dimension isCurated, La métrique "views" est intégrée à une playlist qui indique le nombre de fois où des vidéos ont été regardées dans le contexte du les playlists de la chaîne.
    • Lorsqu'une requête n'inclut pas la dimension isCurated, la La métrique views est une métrique vidéo agrégée qui spécifie le nombre total de visionnages de cette vidéo dans les playlists de la chaîne, que ces ont été enregistrées dans le contexte d'une playlist. Le total cumulé ne comprend que les vues de les vidéos appartenant à la chaîne propriétaire de la playlist.

      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. Elle comptabilise les vues de toutes les vidéos de la playlist, quelle que soit la chaîne qui les possède.

  • Pour chaque rapport sur les playlists, les rapports sur la chaîne la documentation inclut désormais des tableaux indiquant les métriques acceptées pour ce rapport en fonction si la requête API inclut la dimension isCurated. Reportez-vous à la section définissant rapports sur les playlists basées sur la durée à titre d'exemple.

4 décembre 2023

L'API YouTube Analytics (Requêtes ciblées) a été mise à jour pour fusionner deux insightTrafficSourceType des valeurs de dimension. Auparavant, la dimension différenciait les vidéos lues dans une playlist. (PLAYLIST) et les vues provenant d'une page listant toutes les vidéos d'une playlist (YT_PLAYLIST_PAGE). Dorénavant, ces deux types de vues seront associés au PLAYLIST.

15 décembre 2022

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

  • Un nouveau rapport présente l'activité des utilisateurs par ville. Ce rapport est disponible pour canaux et propriétaires de contenu. Ce rapport contient les nouvelles city qui identifie la ville estimée par YouTube pour l'activité de l'utilisateur.

  • Nouvelle version de creatorContentType identifie le type de contenu YouTube associé à 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 de la chaîne et du propriétaire de contenu.

  • Le guide des exemples de demandes de l'API YouTube Analytics inclut désormais des exemples pour les deux nouvelles dimensions.

  • Les références aux dimensions 7DayTotals et 30DayTotals ont été supprimés 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) prend en charge une nouvelle valeur des détails de la source de trafic:

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

11 février 2022

L'ensemble de valeurs valides pour la dimension "gender" changera à partir d'août 11 mars 2022. Cette modification peut entraîner une incompatibilité ascendante dans la mise en œuvre de votre API. Conformément aux Arrière modifications incompatibles des conditions d'utilisation des services d'API YouTube, cette modification est sera annoncé six mois avant son entrée en vigueur. Veuillez mettre à jour votre implémentation d'API avant le 11 août 2022, afin de faciliter la transition vers le nouvel ensemble de valeurs.

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

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

9 février 2022

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

2 février 2022

L'API YouTube Reporting (Rapports groupés) accepte une nouvelle valeur de dimension "Source de trafic" qui indique que les vues proviennent Live Redirect:

  • Dans l'API de création de rapports YouTube (rapports groupés), le paramètre traffic_source_type prend en charge la valeur 28.

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

23 septembre 2020

L'API YouTube Analytics (Requêtes ciblées) et l'API YouTube Reporting (Rapports groupés) acceptent une nouvelle valeur de dimension "Source de trafic", qui indique que l'utilisateur a été référencé par en balayant l'écran verticalement dans l'expérience de visionnage YouTube Shorts:

  • Dans l'API YouTube Analytics (Requêtes ciblées), le paramètre insightTrafficSourceType prend en charge la valeur SHORTS.
  • Dans l'API de création de rapports YouTube (rapports groupés), le paramètre traffic_source_type prend en charge la valeur 24.

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

20 juillet 2020

Cette mise à jour concerne deux modifications qui affectent l'API YouTube Analytics (Targetedqueries) :

  • La taille maximale d'un rapport YouTube Analytics groupe est passé de 200 à 500 entités.
  • La méthode reports.query filters identifie une liste de filtres à appliquer pour récupérer YouTube Analytics. données. Ce paramètre permet de spécifier plusieurs valeurs pour le paramètre video, playlist, et channel, et les 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 YouTube Analytics (requêtes ciblées) API et 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 possibles concernant les sources de trafic pour les notifications change. Dans les requêtes ciblées : notifications sont signalées comme insightTrafficSourceType=NOTIFICATION. Dans rapports groupés notifications sont signalées comme traffic_source_type=17.

Les nouvelles valeurs de notification réparties entre les vidéos mises en ligne et les diffusions en direct (uploaded) en deux catégories:

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

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

Pour rappel, ces valeurs ne représentent pas les notifications elles-mêmes, mais plutôt le trafic les sources ayant généré certaines vues sur YouTube. Par exemple, si une ligne du rapport indique views=3, traffic_source_type=17 (NOTIFICATION) et traffic_source_detail=uploaded_push, la ligne indique que trois vues correspondent aux clics des spectateurs sur les notifications push envoyées lors de la mise en ligne de la vidéo.

15 octobre 2019

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

  • Remarque:Le présent message est une annonce d'abandon.

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

    Notez que les utilisateurs peuvent reproduire certaines des données de ces dimensions en effectuant des requêtes à l'aide de la dimension day, puis en agrégeant ou en extrayant les données sur des périodes de 7 ou 30 jours. Exemple :

    • Le nombre de vues sur une période de sept jours peut être calculé en agrégeant le nombre de vues enregistrées pour chaque jour de cette période.
    • La métrique "ViewerPercentage" pour une période de sept jours peut être calculée en multipliant le nombre de vues enregistrées chaque jour par le "viewerPercentage" pour ce jour. Cela permet d'obtenir le nombre d'utilisateurs connectés lors du visionnage de la vidéo ce jour-là. Ensuite, le nombre de spectateurs connectés peut être ajouté pour l'ensemble de la période, puis divisé par le nombre total de vues pour cette période afin d'obtenir le "ViewerPercentage" pour 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 sur des jours différents. Toutefois, vous pouvez peut-être utiliser la dimension month au lieu de la dimension 30DayTotals pour extrapoler des 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 des 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 concernant 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 concernant 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 afin qu'ils utilisent la version 2 de l'API dès que possible afin de minimiser les interruptions de service. Pour en savoir plus, consultez le guide de migration.

    Notez que le calendrier d'abandon a été initialement annoncé le 26 avril 2018.

17 septembre 2018

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

  • La nouvelle section sur l'anonymisation des données dans le 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 tout ou partie de vos données si:

    1. d'une vidéo ou d'une chaîne dont le trafic 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 ;

    La nouvelle section inclut également une discussion sur les types de données susceptibles d'être limités dans les rapports YouTube Analytics.

  • Les documents concernant 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 le type d'appareil/système d'exploitation.

18 juin 2018

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

  • Les exigences concernant le champ d'application des méthodes suivantes ont changé: <ph type="x-smartling-placeholder">
      </ph>
    • 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 à: <ph type="x-smartling-placeholder">
        </ph>
      • le champ d'application https://www.googleapis.com/auth/youtube
        ou
      • le https://www.googleapis.com/auth/youtube.readonlychamp d'application
        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 en lecture-écriture, tandis que la seconde utilise deux champs d'application en lecture seule.

23 mai 2018

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

  • La présentation de l'API contient une nouvelle section, Métriques agrégées et éléments supprimés, qui explique comment les réponses de l'API traitent les données associées aux ressources supprimées, telles que les vidéos, les playlists ou les chaînes.
  • La section Bonnes pratiques de la page "Présentation de l'API" a été mise à jour pour vous rappeler que vous pouvez utiliser l'API YouTube Data pour récupérer des métadonnées supplémentaires pour les ressources identifiées dans les réponses de l'API YouTube Analytics. Comme indiqué dans le Règlement 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 des ressources stockées à partir de cette API au bout de 30 jours.

22 mai 2018

Cette mise à jour contient les modifications suivantes concernant l'API YouTube Reporting (Bulk Reports) :

  • Les modifications suivantes devraient entrer en vigueur en juillet 2018. Les nouvelles règles s'appliquent globalement à l'ensemble des rapports et des tâches de création de rapports.

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

      Avant cette annonce, tous les rapports de l'API étaient disponibles pendant 180 jours à compter de leur génération. Nous tenons à préciser que lorsque cette modification des règles entrera en vigueur, les rapports de données historiques datant de plus de 30 jours ne seront plus accessibles via l'API. Tous les autres rapports datant de plus de 60 jours ne seront plus accessibles non plus. Par conséquent, la documentation indique désormais que les rapports créés avant la modification des règles seront disponibles pendant jusqu'à 180 jours.

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

  • La section Bonnes pratiques a été mise à jour pour vous rappeler que vous pouvez utiliser l'API YouTube Data pour récupérer des métadonnées supplémentaires pour les ressources identifiées dans les rapports. Comme indiqué dans le Règlement 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 des ressources stockées à partir 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 des rapports ne sont pas filtrées, les rapports contenant des données pour une période antérieure au 1er juin 2018 ne contiendront aucune référence à des ressources YouTube supprimées au moins 30 jours avant la date de génération du rapport.

  • La section Données historiques de la présentation de l'API a été mise à jour pour indiquer que lorsque vous planifiez une nouvelle tâche de création de rapports, les rapports historiques sont généralement publiés dans un délai de quelques jours. Auparavant, la documentation indiquait que cela peut prendre jusqu'à 30 jours pour que ces rapports soient disponibles.

  • La section Données de remplissage de la présentation de l'API a été mise à jour pour définir plus clairement les données de remplissage en tant qu'ensembles de données qui remplacent un ensemble fourni précédemment.

26 avril 2018

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

  • La version 2 de l'API est presque identique à la version 1. Cependant, vous devrez probablement mettre à jour votre code pour refléter les modifications indiqué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.
    • Les noms de plusieurs paramètres de la méthode reports.query ont été mis à jour. Plus précisément, les noms de paramètres qui contiennent des traits d'union, comme end-date dans l'API v1, utilisent camel case (endDate) plutôt que des traits d'union dans l'API v2. Cette modification garantit la cohérence des noms de paramètres dans l'ensemble de l'API, car les méthodes de l'API pour créer et gérer des groupes utilisaient déjà la casse Camel pour les noms des paramètres.
    • L'API v2 n'est pas compatible avec les requêtes par lot envoyées au point de terminaison HTTP par lot global de Google (www.googleapis.com/batch). Si vous envoyez des requêtes par lot dans l'API v2, 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 l'API v2:

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

  • Remarque:Le présent message est une annonce d'abandon.

    La version 1 de l'API (v1) est désormais obsolète et sera compatible jusqu'au 31 octobre 2018. Toutes les requêtes envoyées à l'API v1 cesseront de fonctionner après cette date. Par conséquent, veuillez passer à la version 2 au plus tard le 31 octobre 2018 pour que votre accès aux données YouTube Analytics via cette API soit interrompu.

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 des spectateurs La tranche d'âge et le genre ne sont plus compatibles avec la dimension youtubeProduct, qui identifie le service YouTube sur lequel l'activité de l'utilisateur 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: <ph type="x-smartling-placeholder">
        </ph>
      • 25: KaiOS

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

20 décembre 2017

Cette mise à jour inclut deux modifications concernant l'API YouTube Reporting:

  • Le serveur d'API prend désormais en charge la compression gzip pour les requêtes de téléchargement de rapports. Notez que la compression gzip n'est pas compatible avec les autres types de requêtes API. L'activation de la compression gzip réduit la bande passante nécessaire pour chaque réponse de l'API. Par ailleurs, même si votre application a besoin de temps CPU supplémentaire pour décompresser les réponses de l'API, l'avantage d'une consommation moins importante des ressources réseau compense généralement ce coût.

    Pour recevoir une réponse encodée au format gzip, définissez l'en-tête de requête HTTP Accept-Encoding sur gzip, comme 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 relative aux dimensions age group et gender a été corrigée afin d'afficher les valeurs réelles renvoyées par l'API pour ces dimensions. Notez qu'il s'agit d'une correction de la documentation et qu'il ne reflète pas un changement au niveau des fonctionnalités ou du comportement de l'API. Plus précisément, les valeurs suivantes ont été modifiées:

    • Les valeurs de la dimension age_group utilisent des lettres majuscules, 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 respectivement en AGE_13_17 et AGE_18_24.
    • 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 annonçait l'abandon de la métrique earnings de l'API YouTube Analytics. (Dans le même temps, l'API a ajouté la prise en charge d'une nouvelle métrique, nommée estimatedRevenue, qui fournit les mêmes données.)

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

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

6 juillet 2017

Cette mise à jour inclut les changements suivants :

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

    • La documentation de l'API a été mise à jour pour refléter le fait que les réponses de l'API contiennent des données jusqu'au dernier jour de la plage de dates demandée pour laquelle toutes les métriques interrogées sont disponibles.

      Par exemple, si la date de fin d'une demande est le 5 juillet 2017 et que les valeurs de toutes les métriques demandées ne sont disponibles que jusqu'au 3 juillet 2017, il s'agit de la date à laquelle des données sont incluses pour la dernière fois dans la réponse. Cela est vrai même si les données de certaines des métriques demandées sont disponibles depuis le 4 juillet 2017.

    • La dimension adType accepte désormais la valeur reservedBumperInstream, qui fait référence à une annonce vidéo non désactivable d'une durée maximale de six secondes qui est lue avant de pouvoir regarder une vidéo. 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, et non via un système 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éservation. Les annonces bumper sont des annonces vidéo non désactivables de six secondes maximum qui sont diffusées avant de pouvoir regarder les vidéos. Notez que la valeur 19 pour cette dimension fait également référence aux annonces bumper vendues via un système d'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

      L'abandon de ces types de rapports a été annoncé le 15 septembre 2016. Les rapports correspondants n'ont plus été générés après le 15 décembre 2016. Les rapports générés précédemment étaient encore disponibles pendant 180 jours à compter de leur création. Certains rapports étaient donc accessibles jusqu'au 15 juin 2017. Cependant, comme les rapports ne sont plus disponibles, les tâches qui leur sont associées ne sont pas non plus nécessaires.

24 mai 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Ces types de rapports ont été annoncés comme obsolètes le 22 juin 2016. Les rapports correspondants n'ont plus été générés depuis le 22 septembre 2016. Les rapports générés précédemment étaient encore disponibles pendant 180 jours à compter de leur création. Par conséquent, certains rapports étaient accessibles jusqu'au 22 mars 2017. Cependant, comme 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 afin de la différencier plus clairement de la valeur 73 (Kakao Story). Cette modification ne reflète pas un 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

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

17 mars 2017

Cette mise à jour inclut les changements suivants :

  • L'API YouTube Analytics est compatible avec les métriques redViews et estimatedRedMinutesWatched, qui se rapportent toutes deux au nombre de spectateurs YouTube Red. L'API est d'ailleurs compatible avec ces métriques depuis un certain temps, et l'API YouTube Reporting est déjà compatible avec les deux métriques, comme annoncé le 15 septembre 2016.

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

    La documentation relative aux rapports sur les canaux et aux rapports sur les propriétaires de contenu a été mise à jour pour indiquer les rapports compatibles avec ces deux nouvelles métriques. Ils sont acceptés dans tous les rapports qui étaient déjà compatibles avec 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. Sa valeur fait référence à la période commençant à 00h00 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, les dates d'ajustement des horloges représentent une période de 23 heures et les dates pour lesquelles les horloges sont ajustées en arrière représentent une période de 25 heures. (Auparavant, la documentation indiquait que chaque date représentait une période unique de 24 heures et que l'heure du Pacifique était toujours UTC-8.)

      Notez que cette correction ne représente pas un changement dans 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: <ph type="x-smartling-placeholder">
        </ph>
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Tous les jobs de création de rapports pour le type de rapport content_owner_basic_a1 ont été supprimés. Ce type de rapport n'était plus valable depuis 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. Par conséquent, certains rapports étaient accessibles jusqu'au 19 février 2017. Cependant, comme 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. La valeur de la dimension fait référence à la période commençant à 00h00 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, les dates d'ajustement des horloges représentent une période de 23 heures et les dates pour lesquelles les horloges sont ajustées en arrière représentent une période de 25 heures. (Auparavant, la documentation indiquait que l'heure du Pacifique était UTC-8 et ne mentionnait pas la possibilité qu'une journée ne corresponde pas à une période de 24 heures.)

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

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

    • La dimension operatingSystem accepte trois nouvelles valeurs de dimension: <ph type="x-smartling-placeholder">
        </ph>
      • 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 lors de la récupération de rapports de propriétaires de contenu.

Ce paramètre permet à un propriétaire de contenu d'indiquer qu'une réponse de l'API doit inclure des chaînes la durée de visionnage et les données sur les vues enregistrées pour la période antérieure à l'association des chaînes au propriétaire de contenu. La valeur par défaut du paramètre est false. Cela signifie que, par défaut, la réponse de l'API n'inclut que les données sur la durée de visionnage et les vues enregistrées au moment où les chaînes ont été associées au propriétaire de contenu.

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

  • Si la valeur du paramètre est false, les données sur la durée de visionnage et les vues 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 plusieurs chaînes peuvent avoir été associées à un propriétaire de contenu à des dates différentes. Si la requête API récupère des données pour plusieurs chaînes et que la valeur du paramètre est false, la réponse de l'API contient des données sur la durée de visionnage et la vue en fonction de la date d'association de chaque chaîne.
  • Si la valeur du paramètre est true, la réponse renvoie la durée de visionnage et les données de vue pour toutes les chaînes en fonction des dates de début et de fin spécifiées dans la requête API.

15 décembre 2016

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

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

11 novembre 2016

Cette mise à jour inclut les changements suivants :

    L'API 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 de la vidéo.

    8 novembre 2016

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

    • Les métriques de la liste suivante sont totalement obsolètes et ne sont plus compatibles. Comme annoncé le 10 août 2016, de nouvelles statistiques faisant référence aux mêmes données sont déjà disponibles. Le tableau ci-dessous présente le nom de la métrique obsolète et celui du nouveau:

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

    27 octobre 2016

    YouTube génère désormais automatiquement un ensemble de rapports sur les revenus publicitaires gérés par le système pour les propriétaires de contenu ayant accès aux rapports correspondants dans la section Rapports de Creator Studio. Les nouveaux rapports sur les 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 présente brièvement les nouveaux rapports et explique le processus permettant de les récupérer via l'API. Cette procédure est légèrement différente de celle qui permet de 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 une liste des rapports gérés par le système auxquels vous pouvez accéder via l'API:

    • Revenus publicitaires mensuels dans le monde entier par vidéo
    • Revenus publicitaires quotidiens par pays et par vidéo
    • Revenus publicitaires mensuels mondiaux par élément
    • Revenus publicitaires quotidiens par pays et par élément
    • Revendications (ce rapport ne contient aucune donnée sur les revenus)

    27 septembre 2016

    Remarque:Le présent message est une annonce d'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:

    19 août 2016

    Cette mise à jour contient 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. En revanche, les rapports déjà générés resteront disponibles pendant 180 jours à compter de leur création.

      Le rapport 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"), présentées en détail sur le blog YouTube Engineering and Developers, fournissent 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 comprend 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. De plus, les modifications futures apportées aux Conditions mises à jour ou aux documents connexes seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS listant les modifications apportées dans l'historique des révisions à partir d'un lien figurant dans ce document.

    10 août 2016

    Cette mise à jour inclut les modifications suivantes :

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

      • Remarque:Le présent message est une annonce d'abandon.

        Les métriques du tableau suivant seront bientôt obsolètes. Parallèlement, de nouvelles métriques faisant référence aux mêmes données sont introduites. Les anciennes statistiques sont en effet renommées, même si l'API YouTube Analytics acceptera les deux noms de métriques jusqu'aux dates d'abandon indiquées dans le tableau.

        Ancien nom de la métrique Nouveau nom de la métrique Date d'assistance
        earnings estimatedRevenue 10 août 2017
        adEarnings estimatedAdRevenue 4 novembre 2016
        redPartnerRevenue estimatedRedPartnerRevenue 4 novembre 2016
        impressionBasedCpm cpm 4 novembre 2016
        impressions adImpressions 4 novembre 2016

        Notez que la métrique earnings était l'une des métriques principales. Elle sera donc compatible pendant un an à compter de la date de cette annonce. Les autres statistiques, qui ne faisaient pas partie des statistiques principales, seront acceptées pendant trois mois, soit jusqu'au 4 novembre 2016.

        Par exemple, jusqu'au 4 novembre 2016, une requête API peut spécifier la métrique impressionBasedCpm, la métrique cpm ou les deux. Toutefois, après cette date, seule la métrique cpm sera acceptée.

      • La dimension insightTrafficSourceType accepte deux nouvelles valeurs de dimension: <ph type="x-smartling-placeholder">
          </ph>
        • CAMPAIGN_CARD: cette source de trafic n'est compatible qu'avec les rapports sur les propriétaires de contenu. Il indique que les vues proviennent de vidéos revendiquées mises en ligne par des utilisateurs et utilisées par le propriétaire du contenu pour promouvoir le contenu qu'il a regardé.
        • END_SCREEN: les 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 obtenir un rapport traffic source detail. Dans les deux cas, la dimension insightTrafficSourceDetail identifie la vidéo de provenance du spectateur.

      • La dimension adType accepte désormais la valeur auctionBumperInstream, qui fait référence à une annonce vidéo non désactivable d'une durée maximale de six secondes qui est lue avant de pouvoir regarder une vidéo.

    • API YouTube Reporting (rapports groupés)

      • La dimension traffic_source_type accepte désormais les valeurs suivantes: <ph type="x-smartling-placeholder">
          </ph>
        • 19: cette source de trafic n'est compatible qu'avec les rapports sur les propriétaires de contenu. Il indique que les vues proviennent de vidéos revendiquées mises en ligne par des utilisateurs et utilisées par le propriétaire du contenu pour promouvoir le contenu qu'il a regardé.
        • 20: les données concernent les vues provenant de l'écran de fin d'une autre vidéo.

        Pour les deux nouvelles sources de trafic, la dimension traffic_source_detail identifie la vidéo de provenance du spectateur.

      • La liste des métriques principales de l'API a été corrigée et remplacée par estimated_partner_revenue en tant que métrique principale et dans la suppression de earnings de cette liste. (La métrique earnings n'a jamais été prise en charge dans l'API YouTube Reporting.)

      • La dimension ad_type accepte désormais la valeur 19 qui fait référence aux annonces bumper, qui sont des annonces vidéo non désactivables de six secondes maximum qui sont lues avant qu'une vidéo puisse être visionnée.

    18 juillet 2016

    Cette mise à jour inclut les modifications suivantes :

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

      • Les listes de métriques acceptées pour les rapports sur les canaux suivants ont été mises à jour afin d'inclure les métriques sur les fiches. Les statistiques relatives aux fiches sont ajoutées à ces rapports depuis le 28 juin 2016. L'historique des révisions correspondant à cette date explique ce changement plus en détail. Ces rapports sont les suivants: <ph type="x-smartling-placeholder">
          </ph>
        • Activité de base des utilisateurs pour les États américains
        • Activité des utilisateurs dans les États américains au cours de périodes spécifiques
        • Activité des utilisateurs par province
        • Activité des utilisateurs par état d'abonnement
        • Activité des utilisateurs par statut d'abonnement pour les provinces
        • Top des vidéos par État
        • Top des vidéos pour les spectateurs abonnés et non abonnés

      • Les listes de filtres ont été corrigées dans les rapports sur la rétention d'audience de la chaîne et dans les rapports sur la rétention d'audience des propriétaires de contenu afin d'indiquer que le filtre video est obligatoire et que le filtre group n'est pas compatible.

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

    • 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. Elle indique désormais que YouTube génère des rapports téléchargeables les jours où aucune donnée n'était disponible. Ces rapports comportent une ligne d'en-tête, mais ne contiennent aucune donnée supplémentaire. Ces informations ont 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 d'indiquer que le rapport utilise la dimension card_id. Auparavant, le nom de la dimension était indiqué de manière incorrecte dans la documentation card_title.

    28 juin 2016

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

    Les métriques sont acceptées dans les types de rapports suivants:

    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 ne concernent 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 préciser que les rapports sont disponibles via l'API pendant 180 jours à compter de leur génération.

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

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

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

      • Deux rapports, désormais disponibles dans 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.

        Ces deux rapports, qui viennent d'être renommés, présentent les différences suivantes par rapport à leurs prédécesseurs:

      Notez que si vous disposez déjà de tâches pour créer l'une des anciennes versions de ces rapports, vous devrez en créer d'autres 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 l'un de ces rapports comporte des offres d'emploi, ne vous attendez pas à ce que YouTube génère de nouveaux rapports pour ces tâches après le 22 septembre 2016. Les rapports générés resteront disponibles pendant 180 jours à compter de leur date de création.

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

    • Les noms des deux métriques ont été corrigés dans la documentation pour qu'ils correspondent à ceux figurant dans les rapports. Il s'agit simplement d'une correction de la documentation qui ne reflète pas un changement dans le contenu réel du rapport:

      • La métrique estimated_partner_adsense_revenue a été renommée estimated_partner_ad_sense_revenue. Notez toutefois que cette métrique n'apparaît que dans deux rapports qui seront abandonnés en raison de cette mise à jour. Comme décrit ci-dessus, cette métrique a été renommée estimated_partner_ad_auction_revenue dans les versions plus récentes de ces rapports.
      • La métrique estimated_partner_doubleclick_revenue a été renommée estimated_partner_double_click_revenue. Là encore, notez que cette métrique n'apparaît que dans deux rapports qui seront abandonnés en raison de cette mise à jour. Comme décrit ci-dessus, cette métrique a été renommée estimated_partner_ad_reserved_revenue dans les versions plus récentes de ces rapports.

    • La documentation sur les dimensions pour l'API Reporting a été mise à jour pour ne plus lister 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 avez déjà une tâche pour créer le rapport content_owner_basic_a1, vous devez tout de même créer une tâche pour le rapport content_owner_basic_a2. YouTube ne fait pas migrer automatiquement les propriétaires de contenu vers la nouvelle version du rapport et ne crée pas automatiquement un job pour générer la nouvelle version du rapport. Dans certaines implémentations, l'apparition d'un nouveau job inattendu peut constituer une modification destructive.

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

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

      • La propriété deprecateTime de la ressource reportType spécifie la date et l'heure d'abandon du type de rapport. Cette propriété ne comporte une valeur que pour les rapports annoncés comme obsolètes. La valeur représente la date à laquelle YouTube cessera de générer ce type de rapports.

        Lorsqu'un type de rapport a été annoncé comme obsolète, YouTube génère des rapports du même type pendant trois mois supplémentaires. Par exemple, cette mise à jour du 19 mai 2016 annonce l'abandon du rapport content_owner_basic_a1. Ainsi, le deprecateTime pour ce type de rapport indique une heure, à compter du 19 août 2016, après laquelle YouTube cessera de générer ce type de rapport.

      • La propriété expireTime de la ressource job spécifie la date et l'heure d'expiration ou d'expiration du job. Cette propriété présente 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 pendant une période prolongée. La date indique l'heure à partir de 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 dans la ressource job, comme décrit dans l'élément précédent de cette liste.

    • La méthode jobs.create renvoie désormais un code de réponse HTTP 400 (Bad Request) si vous essayez de créer une tâche pour un rapport obsolète. De plus, la documentation de la méthode répertorie désormais plusieurs autres raisons pouvant entraîner l'échec d'une requête API.

    12 avril 2016

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

    • YouTube génère désormais des données couvrant la période de 180 jours précédant le moment où une tâche de création de rapports a été planifiée pour la première fois. 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 d'une offre d'emploi soient publiées. Ainsi, un mois après la planification d'une tâche de création de rapports, vous aurez accès à environ sept mois de données. (Toutes les données historiques des offres d'emploi créées 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 comporteront moins de 180 jours de données historiques.

      Toutes 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 présentation de l'API YouTube Reporting a été mise à jour avec les modifications suivantes:

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

      • La documentation a été mise à jour pour refléter le fait que l'API génère désormais des rapports téléchargeables pour les jours où aucune donnée n'était disponible. Ces rapports contiendront des lignes d'en-tête, mais pas de données supplémentaires.

    • L'API YouTube Reporting sera bientôt compatible avec un ensemble de rapports générés automatiquement et gérés par le système. Ils contiennent des données sur les revenus publicitaires ou les revenus des abonnements YouTube Premium. Ces rapports sont disponibles pour les propriétaires de contenu qui ont déjà accès à des rapports sur les revenus téléchargeables manuellement dans YouTube Creator Studio. Ainsi, la nouvelle fonctionnalité de l'API fournira un accès programmatique à ces données.

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

      • La nouvelle propriété systemManaged de la ressource job indique si celle-ci décrit une tâche qui génère des rapports gérés par le système. YouTube génère automatiquement des rapports gérés par le système pour les propriétaires de contenu YouTube. Les propriétaires de contenu ne peuvent pas modifier ni supprimer les tâches qui créent ces rapports.

      • Le nouveau paramètre includeSystemManaged de la mé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 premières données du rapport datent de la date spécifiée ou sont postérieures à celles-ci. De même, le paramètre startTimeBefore indique que la réponse de l'API ne doit contenir des rapports que si les premières données du rapport sont antérieures à la date spécifiée.

        Contrairement au paramètre createdAfter de la méthode, qui concerne la date et l'heure de création du rapport, les nouveaux paramètres sont liés aux 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 de vue pour plusieurs services de partage supplémentaires.

    • Dans l'API YouTube Reporting, la dimension sharing_service accepte les nouvelles valeurs suivantes: <ph type="x-smartling-placeholder">
        </ph>
      • 82: boîte de dialogue d'activité du système iOS
      • 83: Boîte de réception Google
      • 84: Android Messenger
    • Dans l'API YouTube Analytics, la dimension sharingService accepte les nouvelles valeurs suivantes: <ph type="x-smartling-placeholder">
        </ph>
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Boîte de réception Google
      • IOS_SYSTEM_ACTIVITY_DIALOG: boîte de dialogue d'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 de dimension: <ph type="x-smartling-placeholder">
        </ph>
      • 7: les données concernent les vues enregistrées sur la page ou l'écran d'accueil YouTube, dans le flux "Abonnements" de l'utilisateur ou via une autre fonctionnalité de navigation YouTube.
      • 8: les données concernent les vues enregistrées directement sur la page des résultats de recherche YouTube.
    • La dimension traffic_source_type accepte désormais 18 comme valeur de dimension. Cette valeur indique que les vues de la vidéo proviennent d'une page qui liste toutes les 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 de dimension: <ph type="x-smartling-placeholder">
        </ph>
      • BROWSE: les données concernent les vues enregistrées sur la page ou l'écran d'accueil YouTube, dans le flux "Abonnements" de l'utilisateur ou via une autre fonctionnalité de navigation YouTube.
      • SEARCH: les données concernent les vues enregistrées directement sur la page des résultats de recherche YouTube.
    • La dimension insightTrafficSourceType accepte désormais YT_PLAYLIST_PAGE comme valeur de dimension. Cette valeur indique que les vues de la vidéo proviennent d'une page qui liste toutes les vidéos d'une playlist. Cette source est différente du type de source PLAYLIST, qui indique que les vues ont eu lieu lorsque la vidéo était lue 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 de sorte que les métriques des fiches ne soient plus listées comme compatibles avec cette API. (Aucun des rapports de cette API n'avait été documenté comme étant compatible avec les métriques des fiches.)

    Sachez que vous pouvez toujours récupérer les métriques de la fiche à l'aide de l'API YouTube Reporting, qui est compatible avec ces métriques pour 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 de manière spécifique les vues générées via un appareil 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 effectuées via Chromecast.

    21 décembre 2015

    Dans la documentation, les noms des métriques annotation_clickable_impressions et annotation_closable_impressions ont été modifiés pour correspondre aux noms renvoyés dans les rapports. Auparavant, les noms étaient présentés sous les noms clickable_annotation_impressions et closable_annotation_impressions.

    18 décembre 2015

    La législation de l'Union européenne (UE) exige que certaines informations soient divulguées aux utilisateurs finaux de l'UE et qu'ils obtiennent leur consentement. Par conséquent, pour les utilisateurs finaux de l'Union européenne, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE. Nous avons ajouté une notification concernant cette exigence dans les Conditions d'utilisation des API YouTube.

    15 décembre 2015

    Cette mise à jour inclut les modifications suivantes, qui concernent toutes l'API YouTube Analytics:

    • L'API YouTube Analytics est désormais compatible avec trois nouvelles dimensions de lecture, que vous pouvez utiliser dans différents rapports sur les chaînes et les propriétaires de contenu:

      • liveOrOnDemand: cette dimension indique si les données du rapport décrivent l'activité d'un utilisateur qui s'est produite pendant une diffusion en direct.
      • subscribedStatus: cette dimension indique si les métriques sur l'activité des utilisateurs dans les données sont associées aux spectateurs qui se sont abonnés à la chaîne de la vidéo ou de la playlist.
      • youtubeProduct: cette dimension identifie la propriété YouTube sur laquelle l'activité de l'utilisateur a eu lieu. Les valeurs possibles sont le site Web (ou l'application YouTube) principal de YouTube, YouTube Gaming et YouTube Kids.

      La documentation a été mise à jour pour identifier les nouveaux rapports détaillés sur la lecture 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 explique le "Type d'appareil" sur les canaux, affiche le nouveau format:

      Sommaire
      Dimensions :
      Obligatoire deviceType
      Utiliser 0 ou plus day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Métriques :
      Utiliser 1 ou plusieurs views, estimatedMinutesWatched
      Filtres :
      Utilisez 0 ou 1 country, province, continent, subContinent
      Utilisez 0 ou 1 vidéo, groupe
      Utiliser 0 ou plus operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

    • L'API YouTube Analytics supprime désormais automatiquement les entités pour lesquelles l'utilisateur 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 des vidéos. Cependant, un ID de vidéo identifie une vidéo appartenant à une autre chaîne, tandis qu'un autre identifie une vidéo qui a été supprimée et qui n'existe donc plus. Dans ce cas, au lieu de renvoyer une erreur, le serveur d'API abandonne les deux vidéos auxquelles l'utilisateur ne peut pas accéder, et la réponse de l'API contient des données pour les 18 vidéos dont l'utilisateur est propriétaire de l'API.

    • Si vous demandez des données pour un group YouTube Analytics vide, l'API renvoie désormais un ensemble de données vide plutôt qu'une erreur.

    • La méthode groupItems.insert de l'API YouTube Analytics renvoie désormais une erreur non autorisée (code de réponse HTTP 403) si vous essayez d'ajouter une entité à un groupe, mais que vous n'y avez pas accès. Auparavant, l'API vous permettait d'ajouter l'entité au groupe, mais elle renvoyait ultérieurement une erreur non autorisée lorsque vous tentiez de récupérer les données de rapport pour ce groupe.

    • La méthode groups.list de l'API YouTube Analytics est désormais compatible avec la pagination. Si la réponse de l'API ne contient pas tous les groupes disponibles, le paramètre nextPageToken de la réponse spécifie un jeton pouvant être utilisé pour récupérer la page de résultats suivante. Définissez le paramètre pageToken de la méthode sur cette valeur pour récupérer des résultats supplémentaires.

    10 novembre 2015

    Cette mise à jour inclut les changements suivants :

    29 octobre 2015

    Cette mise à jour inclut les changements suivants :

    • La documentation concernant la dimension date de l'API de création de rapports YouTube a été corrigée afin de refléter 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 de date (day, 7DayTotals, 30DayTotals et month) font référence à des dates commençant à minuit, heure du Pacifique (UTC-8).

    • La méthode jobs.reports.list() de l'API YouTube Reporting 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 à la date de création du rapport, et non aux dates associées aux données renvoyées.

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

      Les bonnes pratiques concernant l'API YouTube Reporting ont également été mises à jour pour expliquer comment utiliser le paramètre createdAfter pour éviter de traiter plusieurs fois le même rapport.

    • Les définitions de la propriété createTime de la ressource job, ainsi que les propriétés startTime, endTime et createTime de la ressource report ont toutes été corrigées pour indiquer que les valeurs des propriétés sont précises en microsecondes, et non en nanosecondes. De plus, toutes les définitions reflètent désormais avec précision le fait que la valeur de la propriété est un horodatage.

    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 afin d'inclure une liste des valeurs de dimension possibles. La liste comprend un certain nombre de services récemment pris en charge.

      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 correspond à une combinaison unique de valeurs de dimension. Vous pouvez regrouper des données sur plusieurs lignes en fonction des valeurs des dimensions afin de calculer des métriques pour des vidéos, des pays, des vidéos en direct, des 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 tâche, 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 de deux API différentes, les API YouTube Analytics et YouTube Reporting permettent aux développeurs d'extraire des données YouTube Analytics. Étant donné que les deux API permettent d'accéder à des ensembles de données similaires, leur documentation 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 de la documentation de référence et d'autres contenus spécifiques à l'API YouTube Reporting.
      • L'onglet Requêtes ciblées contient de la documentation de référence et d'autres contenus spécifiques à l'API YouTube Analytics.
      • L'onglet Exemples répertorie les exemples de code disponibles pour les deux API.
      • L'onglet Outils répertorie les ressources supplémentaires disponibles pour aider les développeurs à implémenter l'une des deux API.

    20 août 2015

    Cette mise à jour inclut les changements suivants :

    • La documentation de l'API a été restructurée afin de faciliter sa compréhension. Par conséquent, ces modifications ne décrivent pas les nouvelles fonctionnalités:

      • La documentation comprend désormais une page qui répertorie tous les rapports sur les critères disponibles et une autre liste tous les rapports sur les propriétaires de contenu disponibles. Auparavant, la documentation comportait des pages distinctes pour les rapports sur les vidéos de chaînes, les rapports sur les playlists de chaînes, etc.

      • La nouvelle présentation des modèles de données vise à fournir une présentation plus claire du fonctionnement de l'API. Plus précisément, nous essayons de mieux expliquer comment YouTube utilise les métriques, les dimensions et les filtres pour calculer les valeurs des rapports.

      • La méthode reports.query de l'API, que vous utilisez pour récupérer des rapports, est maintenant documentée séparément. Les informations figurant sur cette page figuraient auparavant sur d'autres pages. Cette nouvelle page est conçue pour vous aider à identifier plus facilement les informations que vous devez envoyer pour récupérer un rapport.

    22 juillet 2015

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

    • La nouvelle métrique adEarnings inclut le total des revenus estimés (revenus nets) de toutes les sources de publicité vendues par Google. Il ne s'agit pas d'une métrique essentielle. L'API accepte la métrique adEarnings dans 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 afin de refléter le fait que sa valeur inclut le total des revenus estimés provenant de toutes les sources publicitaires vendues par Google ainsi que des sources non publicitaires. Auparavant, la définition indiquait à tort que la métrique n'incluait que les revenus issus 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.

    • En plus de la métrique primaryAdGrossRevenue obsolète, 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 acceptent toujours ces métriques.

    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 incluses dans le champ d'application de la requête ont été ajoutées à des playlists YouTube. Les vidéos ont peut-être été ajoutées à la playlist du propriétaire ou à d'autres chaînes playlists.
      • videosRemovedFromPlaylists : nombre de fois où des vidéos concernées par la requête ont été supprimées de playlists YouTube. Les vidéos ont peut-être été supprimées de la playlist du propriétaire ou de la chaîne d'autres chaînes playlists.

      Ces deux métriques incluent des playlists par défaut comme la playlist "À regarder plus tard" la playlist. En revanche, elles ne tiennent pas compte des playlists auxquelles une vidéo est ajoutée automatiquement, comme la playlist des vidéos mises en ligne sur 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, puis la supprime, puis l'ajoute de nouveau, les métriques indiquent que la vidéo a été ajoutée à deux playlists et retirée d'une autre.

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

    31 mars 2015

    Cette mise à jour inclut les changements suivants :

    16 mars 2015

    Cette mise à jour inclut les changements suivants :

    • Le nouveau paramètre currency vous permet de récupérer les métriques sur les revenus dans une devise autre que le dollar américain (USD). Si le paramètre est défini, l'API convertit les valeurs des métriques earnings, grossRevenue, playbackBasedCpm et impressionBasedCpm dans la devise spécifiée. Les valeurs affichées sont des estimations calculées à l'aide des taux de change changeants 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 des codes de devise acceptés.

    25 février 2015

    Cette mise à jour inclut les changements suivants :

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

      • Créer et gérer des groupes

        Cette mise à jour introduit les ressources group et groupItem pour créer et gérer des groupes.

        • La ressource group représente un groupe Analytics, c'est-à-dire une collection personnalisée rassemblant un maximum de 200 chaînes, vidéos, playlists ou éléments. L'API accepte les méthodes list, insert, update et delete pour cette ressource.
        • La ressource groupItem représente un élément d'un groupe Analytics. L'API accepte les méthodes list, insert et delete pour cette ressource.

        Par exemple, vous pouvez créer un groupe à l'aide de la méthode groups.insert, puis ajouter des éléments à ce groupe à l'aide de la méthode groupItems.insert.

      • Récupérer des 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 articles de ce groupe. Notez que l'API ne permet pas de créer des rapports pour les groupes d'assets pour le moment.

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

    13 février 2015

    Cette mise à jour inclut les changements suivants :

    • L'API n'accepte plus 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 comme filtres. Si vous souhaitez spécifier plusieurs valeurs, indiquez une liste d'ID de vidéos, de playlists, de chaînes ou de séries pour lesquels la réponse de l'API doit être filtrée, comme valeur du paramètre filters, séparées par une virgule. La valeur du paramètre peut spécifier jusqu'à 200 ID.

      Si vous indiquez plusieurs valeurs pour le même filtre, vous pouvez également ajouter ce filtre à la liste des dimensions que vous spécifiez pour la demande. Cela est vrai même si le filtre n'est pas répertorié comme dimension compatible 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 :

    • Lorsque vous récupérez un rapport sur un canal, vous pouvez désormais récupérer des données concernant 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 de vidéos enregistrées dans le contexte d'une playlist. Les rapports sur les playlists sont disponibles pour les chaînes et les propriétaires de contenu.

      Tous les rapports sur les playlists sont compatibles avec les métriques views et estimatedMinutesWatched, et certains sont également compatibles avec la métrique averageViewDuration.

      De plus, tous les rapports sur les playlists sont compatibles avec les nouvelles métriques ci-dessous. Notez que chacune de ces métriques ne reflète que les vues de playlists effectuées sur le Web.

      • playlistStarts: nombre de fois où des internautes ont lancé la lecture d'une playlist.
      • viewsPerPlaylistStart: nombre moyen de vues de vidéos chaque fois qu'une playlist est lancée.
      • averageTimeInPlaylist: durée moyenne estimée, en minutes, pendant laquelle un internaute a regardé les 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 les rapports sur la rétention d'audience. Ce rapport mesure la capacité d'une vidéo à fidéliser son public. La nouvelle dimension elapsedVideoTimeRatio du rapport mesure le temps écoulé de la vidéo pour les valeurs de métriques correspondantes:

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

        Notez qu'une partie d'une vidéo peut être regardée plusieurs fois au cours d'une même vue (voire jamais). Par exemple, si les utilisateurs reviennent en arrière et regardent plusieurs fois la même partie d'une vidéo, le ratio absolu pour cette partie peut être supérieur à 1.

      • La métrique relativeRetentionPerformance indique la capacité d'une vidéo à fidéliser les spectateurs lors des lectures par rapport à toutes les vidéos YouTube de durée similaire. La valeur 0 indique que la vidéo retient moins bien les internautes que toute autre vidéo de durée similaire, tandis que la valeur 1 indique que la vidéo retient mieux les spectateurs 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 retient moins bien.

      Vous pouvez également utiliser le filtre audienceType pour que le rapport n'affiche que les données associées aux vues naturelles, aux vues provenant d'annonces TrueView InStream ou aux vues provenant d'annonces TrueView InDisplay. Les vues naturelles sont le résultat direct de l'action d'un utilisateur, comme la recherche d'une vidéo ou un clic sur une vidéo suggérée.

    • L'API est compatible avec 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 les métriques annotationClickThroughRate et annotationCloseRate.

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

    • GOOGLE_SEARCH n'est plus indiqué en tant que valeur distincte pour la dimension insightTrafficSourceType. Les sites référents issus des résultats de recherche Google sont désormais attribués au type de source de trafic EXT_URL. Par conséquent, il n'est plus possible non plus de récupérer un rapport insightTrafficSourceDetail qui définit le filtre insightTrafficSourceType sur GOOGLE_SEARCH.

    31 janvier 2014

    Cette mise à jour inclut les changements suivants :

    16 janvier 2014

    Cette mise à jour inclut les changements suivants :

    • Le document Exemples de demandes a été repensé pour regrouper les exemples par catégories et utilise 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é sur le temps
      • Ciblage géographique
      • Contexte de lecture
      • Source de trafic
      • Appareil/OS
      • Catégorie démographique
      • Réseau social
      • Revenus/annonces (pour les rapports sur les propriétaires de contenu uniquement)

    • Le document d'exemples de demandes inclut désormais de nouveaux exemples de récupération de données spécifiques à une province dans les rapports sur les chaînes ou les propriétaires de contenu.

      • Métriques spécifiques à une province pour les États américains et Washington D.C.: Ce rapport présente le nombre de vues et d'autres statistiques, par province, pour 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 et le paramètre filters pour limiter la réponse aux résultats concernant les États-Unis.

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

    • La définition de la dimension province a été mise à jour pour indiquer que lorsque province est inclus dans la valeur du paramètre dimensions, la 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 :

    • Nous avons modifié les documents qui répertorient les rapports sur la chaîne et les propriétaires de contenu compatibles. Au lieu de fournir un tableau listant tous les rapports possibles, chaque document regroupe les rapports en catégories:

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

      Chaque document présente ces catégories sous la forme d'une liste d'onglets. Vous pouvez cliquer sur n'importe quel onglet pour afficher les rapports pris en charge dans 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 le district de Colombie. L'API permet deux utilisations de cette dimension:

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

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

        • Vous pouvez utiliser le paramètre de requête filters pour qu'un rapport ne contienne que les statistiques concernant un état particulier. Plusieurs rapports sont compatibles avec ce type de filtrage, y compris les rapports géographiques, sur les contextes de lecture, sur les sources de trafic, sur les appareils, sur les systèmes d'exploitation, sur les données démographiques et sur 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 que comme filtre.

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

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

    • La documentation a été corrigée : la dimension insightTrafficSourceDetail n'inclut 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 Métriques ont été mises à jour pour afficher les dimensions et métriques principales. En outre, 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 comme valeur pour la dimension insightPlaybackLocationType. Parallèlement à cette mise à jour, depuis le 10 septembre 2013, les lectures en MOBILE ne sont plus classées dans la catégorie des lectures MOBILE. Toutefois, les lectures sur mobile effectuées avant cette date sont toujours classées avec cette valeur.

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

    • L'API accepte désormais PLAYLIST comme valeur pour la dimension insightTrafficSourceType. La valeur indique que les vues de la vidéo proviennent d'une playlist. Auparavant, ces vues é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 demandes contient un nouvel exemple, Trier les demandes selon plusieurs dimensions/métriques, qui illustre cette fonctionnalité. La requête récupère les données de la source de trafic et possède une valeur de paramètre sort de 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 relatives à la source de trafic ayant généré le plus de vues, la deuxième ligne contient les données de la source ayant généré le nombre de vues suivant, et ainsi de suite.

    • L'API accepte désormais deux nouvelles dimensions, deviceType et operatingSystem, qui permettent de récupérer des données concernant les appareils sur lesquels les spectateurs regardent vos vidéos. L'API est compatible avec les rapports qui utilisent l'une des dimensions ou les deux.

      • Le rapport deviceType vous permet de connaître le nombre de vues et la durée de visionnage estimée pour différents types d'appareils, y compris les ordinateurs, les mobiles et les tablettes. Vous pouvez également utiliser le filtre operatingSystem pour que le rapport sur le type d'appareil ne contienne que les statistiques des appareils exécutant un système d'exploitation spécifique, comme Android ou iOS.

      • Le rapport operatingSystem vous permet de connaître le nombre de vues et la durée de visionnage estimée pour différents systèmes d'exploitation, tels qu'Android, iOS, Linux et plus encore. Vous pouvez également utiliser le filtre deviceType pour que le rapport sur le système d'exploitation ne contienne que les statistiques d'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 catégories et les propriétaires de contenu.

    • Le document Exemples de demandes a été mis à jour afin d'inclure trois rapports sur les appareils pour les chaînes et trois rapports sur les appareils pour les propriétaires de contenu.

    • La dimension insightPlaybackLocationType peut renvoyer la valeur YT_OTHER, qui identifie les vues qui ne sont pas classées à l'aide de l'une des autres valeurs de la dimension.

    23 mai 2013

    Cette mise à jour inclut les changements suivants :

    10 mai 2013

    Cette mise à jour inclut les changements suivants :

    6 mai 2013

    Cette mise à jour inclut les changements suivants :

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

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

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

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

      • Ils acceptent désormais un filtre country facultatif.

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

        • Détails des contextes de lecture

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

        • Informations sur les sources de trafic

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

    3 mai 2013

    Cette mise à jour inclut les changements suivants :

    • Le nouveau document Exemples de requêtes API fournit des exemples qui montrent comment récupérer de nombreux types de rapports différents à l'aide de YouTube Analytics API. Chaque exemple inclut une brève description du rapport récupéré par la demande, puis affiche les dimensions, métriques, filtres et 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 provenant des flux de la page d'accueil YouTube ou des fonctionnalités d'abonnement de YouTube. Si vous effectuez un filtrage en fonction de cette source de trafic, le champ insightTrafficSourceDetail spécifie le flux de la page d'accueil ou la page d'où proviennent les vues.

    28 mars 2013

    Cette mise à jour inclut les changements suivants :

    21 mars 2013

    Cette mise à jour inclut les changements suivants :

    • L'API est désormais compatible avec les métriques sur les revenus et les performances des annonces, ainsi que sur de nouveaux rapports sur les performances des annonces. Les métriques et les rapports ne sont accessibles qu'aux partenaires de contenu YouTube qui participent au Programme Partenaire YouTube.

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

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

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

        Remarque:Pour plus d'informations, consultez les définitions des métriques.

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

    • La documentation de l'API a été réorganisée afin que les différents types de rapports soient expliqués sur des pages distinctes. Par conséquent, il existe désormais des pages distinctes expliquant les différents types de rapports sur la chaîne et les rapports sur 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 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, de consulter la requête API et de récupérer des données réelles dans la réponse.

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

      • Le rapport sur les contextes de lecture indique le nombre de vues de vidéos effectuées 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 donnée. Il offre un aperçu 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 provenant de 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 indiquer 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. Ces rapports peuvent regrouper les données d'une période spécifique (un jour, les sept jours précédents, les 30 jours précédents, etc.) ou le pays. Si un rapport regroupe 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 utilisateurs.

    2 octobre 2012

    Cette mise à jour inclut les changements suivants :

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

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

    12 septembre 2012

    Cette mise à jour inclut les changements suivants :

    • La nouvelle section Comprendre l'utilisation des quotas fournit des consignes pour optimiser votre utilisation des quotas d'API. Le serveur d'API calcule le coût de chaque requête, et ce coût est déduit de votre quota d'utilisation de l'API. Étant donné que les différents types de rapports peuvent avoir 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 des dimensions temporelles a été mise à jour pour expliquer que ces dimensions indiquent qu'un rapport Analytics doit agréger les données en fonction d'une période. L'API accepte désormais les dimensions temporelles supplémentaires suivantes:

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

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

    • La section sur les dimensions des entités de reporting a été mise à jour pour indiquer que les requêtes API permettant de récupérer des rapports de propriétaire 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 performantes. Disponibles sous la forme de rapports sur les chaînes ou sur les propriétaires de contenu, ces rapports incluent des métriques (vues, commentaires, mentions "J'aime", etc.) par pays et les détaillent par vidéo. Vous pouvez désormais trier ces rapports en fonction du nombre d'utilisateurs qui se sont abonnés ou se sont désabonnés d'une chaîne depuis la page de lecture de la vidéo.

    • Les définitions des métriques subscribersGained et subscribersLost ont été mises à jour pour expliquer qu'une chaîne peut gagner ou perdre des abonnés à plusieurs endroits, y compris la page de lecture des vidéos, la page de chaîne et 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 de la page de lecture de la vidéo en question.