Historique des révisions

Cette page liste les modifications apportées aux API et les mises à jour de la documentation pour les API YouTube Reporting et YouTube Analytics. Ces deux API permettent aux développeurs d'accéder aux données YouTube Analytics, mais de différentes manières.

4 novembre 2026

Depuis le 15 janvier 2027, la version 1.0 du rapport hebdomadaire sur les références pour les propriétaires de contenu (content_owner_active_references_a1) est obsolète et a été remplacée par la version 1.1 (content_owner_active_references_a2). Veillez à migrer vers la dernière version avant le 15 janvier 2027.

30 octobre 2026

L'API YouTube Reporting est désormais compatible avec les rapports gérés par le système suivants pour les propriétaires de contenu :

Catégorie Nom du rapport ID du type de rapport
Résumés financiers Récapitulatif mensuel des ajustements de la chaîne content_owner_channel_adjustments_summary_a1
Résumés financiers Revenus mensuels des transactions liées aux fonctionnalités payantes content_owner_transactions_paid_features_revenue_a1
Résumés financiers Revenus mensuels des transactions TVOD par titre et par pays tvod_content_owner_country_title_tvod_revenue_a1
Résumés financiers Revenus mensuels des transactions TVOD par pays tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts Créations mensuelles de Shorts à partir d'assets de maisons de disques music_content_owner_shorts_asset_creations_a1
Shorts Vues mensuelles des actifs de Shorts des maisons de disques music_content_owner_shorts_asset_views_a1
Shorts Créations mensuelles de Shorts à partir d'assets d'éditeurs musicaux publisher_content_owner_shorts_asset_creations_a1
Shorts Vues mensuelles des Shorts créés à partir d'assets d'éditeurs musicaux publisher_content_owner_shorts_asset_views_a1
Taxes Rapport récapitulatif mensuel des remboursements des taxes des chaînes affiliées à un réseau multichaîne content_owner_affiliate_tax_refund_summary_a1
Assets Rapport SRMF hebdomadaire publisher_content_owner_weekly_srmf
Assets Rapport quotidien sur l'état des demandes de CAO content_owner_oac_request_status_a1
Assets Rapport quotidien sur la qualité des demandes de CAO content_owner_oac_quality_status_a1

13 septembre 2026

L'API YouTube Reporting est désormais compatible avec la version 1.1 du rapport hebdomadaire sur les références pour les propriétaires de contenu (content_owner_active_references_a2).

La version 1.1 introduit les modifications suivantes :

  • Ajout du champ status_detail, qui fournit des détails ou des raisons supplémentaires concernant l'état du fichier de référence.
  • Met à jour le champ asset_owners pour utiliser les noms à afficher ou les ID externes des propriétaires de contenu au lieu des codes de partenaire.

La version précédente du rapport, la version 1.0 (content_owner_active_references_a1), reste disponible.

9 septembre 2026

La documentation des API YouTube Analytics et YouTube Reporting a été mise à jour avec les ajouts et clarifications suivants :

  • SLA sur la fraîcheur des données et la latence : ajout d'une section dédiée à la page Modèle de données expliquant le délai de traitement des données de 48 à 72 heures, la troncature de la date de fin au dernier jour entièrement traité et recommandant la méthode videos.list de l'API YouTube Data pour les statistiques vidéo en temps réel.

  • Métriques monétaires dans les rapports sur les chaînes : nous avons mis à jour la documentation sur l'autorisation des rapports sur les chaînes pour préciser que les métriques sur les revenus estimés et les métriques de performance des annonces sont disponibles pour les rapports sur les chaînes autorisés avec le champ d'application https://www.googleapis.com/auth/yt-analytics-monetary.readonly lorsque la chaîne est membre du Programme Partenaire YouTube, et que les chaînes non monétisées renvoient l'erreur HTTP 403 Forbidden.

  • Contraintes de requête et compatibilité des paramètres : ajout d'une note d'avertissement à la section Comprendre les tableaux de rapport, précisant que les combinaisons de dimensions, de métriques et de filtres non valides ou mutuellement exclusives renvoient le code HTTP 400 badRequest ("The query is not supported.").

  • Valeurs de dimension vides dans les rapports groupés : mise à jour des caractéristiques des rapports de l'API YouTube Reporting pour expliquer que les colonnes de dimension telles que video_id ou channel_id contiennent des chaînes vides afin de préserver les nombres de métriques agrégées pour les ressources supprimées et de représenter les événements au niveau de la chaîne.

27 août 2026

YouTube va harmoniser le calcul des vues publiques pour tous les formats vidéo : vidéos longues, diffusions en direct et Shorts. YouTube comptabilisera les vues publiques dès l'instant où la lecture d'une vidéo commencera.

L'éligibilité à la monétisation et la majorité des métriques de performances principales ne sont pas affectées, car elles restent basées sur les métriques d'engagement. Leurs revenus continueront de dépendre des vues engagées de Shorts et des heures de visionnage engagées accessibles dans YouTube Analytics > Mode avancé.

Les critères d'éligibilité au Programme Partenaire YouTube restent inchangés. De plus, les critères d'éligibilité au Programme Partenaire YouTube ne seront plus désignés par les termes "Vues valides de Shorts publics" ou "Heures de visionnage valides sur des vidéos publiques". Nous parlerons désormais de "Vues de Shorts qualifiées" et d'"Heures de visionnage qualifiées".

Pour en savoir plus, consultez Comprendre les performances de vos contenus YouTube.

Métrique État Déclencheur Utilisation
Afficher Mise à jour La vidéo est lue à partir de la première image (y compris la lecture automatique, le survol et le clic/l'appui pour lire). Nombre de vues publiques standard.
Vue volontaire Non modifié La lecture se poursuit au-delà de la première image, ou l'utilisateur clique/appuie pour lancer la lecture. Monétisation via le Programme Partenaire YouTube, la plupart des données analytiques principales (taux de clics, durée moyenne de visionnage) et rapports sur l'engagement.
Impression de miniature Non modifié La miniature s'affiche sans interaction ni lecture automatique. Mesure l'exposition et le packaging au niveau du flux.

Mises à jour de la documentation de l'API : mise à jour de la définition de la métrique engagedViews dans la documentation sur les métriques de l'API YouTube Analytics et les métriques de l'API YouTube Reporting.

25 juin 2026

La documentation de l'API YouTube Analytics (requêtes ciblées) a été mise à jour pour supprimer le rapport Activité des utilisateurs par ville pour les propriétaires de contenu. Ce rapport n'est pas disponible pour les propriétaires de contenu. Les requêtes des propriétaires de contenu concernant l'activité des utilisateurs par ville ne renverront aucun résultat.

9 mars 2026

Les dimensions ageGroup (API YouTube Analytics) et age_group (API YouTube Reporting) incluent désormais les utilisateurs que YouTube estime avoir moins de 18 ans.

15 janvier 2026

L'API YouTube Reporting est désormais compatible avec les rapports sur la couverture pour les chaînes et les propriétaires de contenu. Les rapports sur la couverture fournissent des statistiques sur les impressions et les taux de clics des miniatures de vos vidéos.

  • Les rapports channel_reach_basic_a1 et channel_reach_combined_a1 sont disponibles pour les chaînes.
  • Les rapports content_owner_reach_basic_a1 et content_owner_reach_combined_a1 sont disponibles pour les propriétaires de contenu.

Ces rapports sont compatibles avec les nouvelles métriques suivantes :

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

Septembre

L'abandon des rapports précédemment annoncé a été repoussé du 30 septembre 2025 au 31 octobre 2025. Les versions précédentes des rapports mis à jour pour refléter les changements apportés au nombre de vues des Shorts resteront disponibles jusqu'à cette date, à l'exception du rapport sur les revendications v1.0 (content_owner_active_claims_a1) et du rapport sur les revendications v1.1 (content_owner_active_claims_a2), qui seront toujours abandonnés le 30 septembre.

24 juin 2025

Comme annoncé le 26 mars 2025, l'API Rapports groupés sera mise à jour dans le cadre de la nouvelle modification du nombre de vues des Shorts. Les modifications suivantes ont été apportées :

  • De nouvelles versions ont été créées pour chaque rapport incluant des vues, ce qui est le cas de la majorité des rapports. La version de chaque rapport concerné a été incrémentée de un (par exemple, de la version a2 à la version a3).
  • Pour les Shorts, les vues comptabiliseront désormais le nombre de fois où un Short commence à être regardé ou est regardé à nouveau. Pour les vidéos, rien ne change.
  • Les rapports mis à jour incluront une nouvelle colonne, engaged_views, qui reflétera l'ancienne méthode de comptabilisation des vues.

Ces modifications entreront en vigueur le 30 juin 2025 pour l'API Rapports groupés. Veillez à ajuster le traitement de vos rapports en conséquence.

Les versions précédentes des rapports seront disponibles jusqu'au 30 septembre 2025. Après le 30 septembre 2025, les versions précédentes seront obsolètes. Veillez à migrer vers les dernières versions.

Enfin, veillez à suivre les bonnes pratiques lors du traitement des rapports pour éviter que de futures modifications apportées aux rapports n'interrompent vos pipelines de traitement.

Les tableaux suivants présentent les nouvelles versions de rapport pour chaque type de rapport :

Rapports de données groupées pour YouTube Analytics

Rapports sur les canaux – Rapports sur les vidéos
Nom du rapport Version précédente Dernière version
Activité de l'utilisateur channel_basic_a2 channel_basic_a3
Activité des utilisateurs par province channel_province_a2 channel_province_a3
Contextes de lecture channel_playback_location_a2 channel_playback_location_a3
Sources de trafic channel_traffic_source_a2 channel_traffic_source_a3
le type d'appareil et le système d'exploitation ; channel_device_os_a2 channel_device_os_a3
Sous-titres channel_subtitles_a2 channel_subtitles_a3
Combinées channel_combined_a2 channel_combined_a3
Rapports sur les chaînes – Rapports sur les playlists
Nom du rapport Version précédente Dernière version
Activité de l'utilisateur playlist_basic_a1 playlist_basic_a2
Activité des utilisateurs par province playlist_province_a1 playlist_province_a2
Contextes de lecture playlist_playback_location_a1 playlist_playback_location_a2
Sources de trafic playlist_traffic_source_a1 playlist_traffic_source_a2
le type d'appareil et le système d'exploitation ; playlist_device_os_a1 playlist_device_os_a2
Combinées playlist_combined_a1 playlist_combined_a2
Rapports pour les propriétaires de contenu – Rapports sur les vidéos
Nom du rapport Version précédente Dernière version
Activité de l'utilisateur content_owner_basic_a3 content_owner_basic_a4
Activité des utilisateurs par province content_owner_province_a2 content_owner_province_a3
Contextes de lecture content_owner_playback_location_a2 content_owner_playback_location_a3
Sources de trafic content_owner_traffic_source_a2 content_owner_traffic_source_a3
le type d'appareil et le système d'exploitation ; content_owner_device_os_a2 content_owner_device_os_a3
Sous-titres content_owner_subtitles_a2 content_owner_subtitles_a3
Combinées content_owner_combined_a2 content_owner_combined_a3
Rapports pour les propriétaires de contenu – Rapports sur les playlists
Nom du rapport Version précédente Dernière version
Activité de l'utilisateur content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Activité des utilisateurs par province content_owner_playlist_province_a1 content_owner_playlist_province_a2
Contextes de lecture content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Sources de trafic content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
le type d'appareil et le système d'exploitation ; content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Combinées content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Rapports pour les propriétaires de contenu – Rapports sur les éléments
Nom du rapport Version précédente Dernière version
Activité de l'utilisateur content_owner_asset_basic_a2 content_owner_asset_basic_a3
Activité des utilisateurs par province content_owner_asset_province_a2 content_owner_asset_province_a3
Contextes de lecture vidéo content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Sources de trafic content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
le type d'appareil et le système d'exploitation ; content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Combinées content_owner_asset_combined_a2 content_owner_asset_combined_a3

Rapports gérés par le système – Financiers (non musicaux)

Rapports sur les propriétaires de contenu – Rapports sur les Shorts (non musicaux)
Nom du rapport Version précédente Dernière version
Récapitulatif des revenus publicitaires mondiaux content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Résumé quotidien des revenus publicitaires content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Récapitulatif des revenus publicitaires par pays content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Récapitulatif des revenus publicitaires content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Rapports gérés par le système – Non financiers

Rapports de propriétaires de contenu – Rapports sur les revendications
Nom du rapport Version précédente Dernière version
Revendications actives content_owner_active_claims_a2 content_owner_active_claims_a3
Rapports de propriétaires de contenu – Rapports sur les métadonnées des vidéos
Nom du rapport Version précédente Dernière version
Métadonnées de vidéo content_owner_video_metadata_a3 content_owner_video_metadata_a4
Rapports pour les propriétaires de contenu – Rapports sur les éléments
Nom du rapport Version précédente Dernière version
Éléments content_owner_asset_a2 content_owner_asset_a3
Conflits d'éléments content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 avril 2025

Comme annoncé le 26 mars 2025, l'API Requêtes ciblées sera mise à jour dans le cadre de la modification du nombre de vues des Shorts :

  • Pour les Shorts, views comptabilisera désormais le nombre de fois où un Short commence à être regardé ou est regardé à nouveau.
  • Une nouvelle métrique, engagedViews, reflétera l'ancienne méthode de comptabilisation des vues. engagedViews sera disponible dans tous les rapports, ainsi que views.

Ces modifications entreront en vigueur le 30 avril 2025 pour l'API Requêtes ciblées. Veillez à ajuster vos requêtes en conséquence.

Consultez cet historique des révisions pour savoir quelles modifications seront apportées à l'API Rapports groupés et quand.

22 avril 2025

Comme annoncé le 7 avril 2024, la dimension isCurated est obsolète pour les rapports sur les chaînes et les rapports sur les playlists des propriétaires de contenu. À partir du 31 décembre 2024, la dimension ne sera plus acceptée. La dimension a été supprimée des rapports et de la documentation.

26 mars 2025

Cette mise à jour inclut la modification suivante concernant les API YouTube Analytics et YouTube Reporting :

À partir du 31 mars 2025, YouTube modifiera la façon dont les vues des Shorts sont comptabilisées. Auparavant, pour les Shorts, une vue était comptabilisée lorsqu'un Short était regardé pendant un certain nombre de secondes. Désormais, les vues comptabiliseront le nombre de fois que votre Short commence à être regardé ou est regardé à nouveau, sans durée de visionnage minimale requise. En savoir plus

Les API YouTube Analytics (requêtes ciblées) et Reporting (rapports groupés) seront mises à jour avec les modifications suivantes :

  • Pour les Shorts, les views comptabilisent le nombre de fois qu'un Short commence à être regardé ou est regardé à nouveau.
  • Une nouvelle métrique, engagedViews, sera disponible et reflétera l'ancienne méthode de calcul des vues.
  • Si vous possédez une chaîne ou disposez des autorisations nécessaires pour accéder à ses données, vous pourrez consulter à la fois la métrique "Vues" mise à jour et la métrique "Vues engagées".

Les requêtes ciblées seront mises à jour d'ici le 30 avril, et les rapports groupés d'ici le 30 juin. En attendant, les vues seront basées sur l'ancienne méthodologie. Le nombre de vues des Shorts et de la chaîne ne correspondra pas à celui d'Analytics dans Studio.

De plus, l'abandon annoncé précédemment du rapport sur les revendications quotidiennes (version 1.0) a été reporté.

Consultez cet historique des révisions pour savoir quand des modifications sont apportées aux API.

3 mars 2025

Cette mise à jour inclut la modification suivante concernant l'API YouTube Reporting :

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

Le rapport Revendications quotidiennes (version 1.0) est obsolète pour les partenaires. Elle ne sera plus prise en charge à partir du 30 avril 2025. La définition de ce rapport a été mise à jour en conséquence. Utilisez plutôt le dernier rapport "Réclamations quotidiennes".

15 novembre 2024

Remarque : La modification suivante est effective depuis le 18 novembre 2024.

La documentation de l'API YouTube Analytics (requêtes ciblées) a été mise à jour pour indiquer que, pour les rapports sur les sources de trafic, la méthode reports.query de l'API renvoie désormais une erreur si le produit du nombre de vidéos interrogées par le nombre de jours de la plage de dates dépasse 50 000. Par exemple, une requête qui récupère des données pour 500 ID vidéo peut demander des données pour un maximum de 100 jours.

Cette modification concerne les rapports des chaînes et des propriétaires de contenu.

Pour réduire le nombre de lignes renvoyées par une requête, divisez-la en plusieurs requêtes spécifiant moins de vidéos ou définissant des plages de dates plus courtes. En règle générale, les rapports groupés sont recommandés pour les grands ensembles de données.

6 mai 2024

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

De plus, le rapport Rétention d'audience a été amélioré pour prendre en charge trois nouvelles métriques :

7 avril 2024

L'API YouTube Analytics (requêtes ciblées) comporte plusieurs mises à jour concernant les rapports sur les playlists des propriétaires de contenu. Ces modifications sont identiques à celles concernant les rapports sur les playlists de chaînes, qui ont été annoncées le 19 janvier 2024.

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

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

    La dimension isCurated est obsolète pour les rapports sur les playlists des propriétaires de contenu. Il ne sera plus pris en charge à partir du 31 décembre 2024. La définition de cette dimension a été mise à jour en conséquence.

    Pour préserver la rétrocompatibilité lorsque vous supprimez la dimension isCurated, vous devez également mettre à jour votre code pour récupérer la métrique playlistViews au lieu de la métrique views pour les rapports sur les playlists uniquement. Étant donné que la métrique views est toujours compatible avec les rapports sur les playlists, bien qu'elle ait une signification différente, l'API 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 à la fois views et playlistViews.

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

    • Les filtres de zone géographique, tels que continent et subcontinent, ne sont pas compatibles avec les nouveaux rapports sur les playlists de chaînes.
    • Les métriques redViews et estimatedRedMinutesWatched ne sont plus acceptées pour les nouveaux rapports sur les playlists de chaînes. Ces métriques n'étaient pas disponibles dans YouTube Studio. Cette modification permet donc d'aligner les fonctionnalités de l'API sur celles disponibles dans l'application Studio.
    • Les dimensions subscribedStatus et youtubeProduct ne sont plus acceptées comme filtres pour les rapports sur les playlists de chaînes. Ces filtres n'étaient pas disponibles dans YouTube Studio. Cette modification aligne donc les fonctionnalités de l'API sur celles disponibles dans l'application Studio.

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

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

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

  • Le comportement de la métrique views dépend désormais de l'utilisation ou non de la dimension isCurated par la requête API qui a récupéré le rapport sur la playlist :

    • Lorsqu'une requête inclut la dimension isCurated, la métrique views est une métrique de playlist qui indique le nombre de fois que les vidéos ont été visionnées dans le contexte des playlists du propriétaire de contenu.
    • Lorsqu'une requête n'inclut pas la dimension isCurated, la métrique views est une métrique vidéo agrégée qui spécifie le nombre total de fois où les vidéos des playlists du propriétaire de contenu ont été visionnées, que ces vues aient eu lieu ou non dans le contexte de la playlist. Le total agrégé n'inclut que les vues des vidéos appartenant au propriétaire de contenu associé à 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ù les vidéos ont été visionnées dans le contexte de la playlist. Cette métrique comptabilise les vues de toutes les vidéos de la playlist, quelle que soit la chaîne à laquelle elles appartiennent.

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

19 janvier 2024

L'API YouTube Analytics (requêtes ciblées) comporte plusieurs mises à jour concernant les rapports sur les playlists des chaînes. Les mises à jour incluent une dimension obsolète, ainsi que plusieurs métriques nouvelles et mises à jour :

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

    La dimension isCurated a été abandonnée pour les rapports sur les chaînes. Il ne sera plus pris en charge à partir du 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 la dimension isCurated, vous devez également 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. Étant donné que la métrique views est toujours compatible avec les rapports sur les playlists, bien qu'elle ait une signification différente, l'API 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 à la fois views et playlistViews.

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

    • Les filtres de zone géographique, tels que continent et subcontinent, ne sont pas compatibles avec les nouveaux rapports sur les playlists de chaînes.
    • Les métriques redViews et estimatedRedMinutesWatched ne sont plus acceptées pour les nouveaux rapports sur les playlists de chaînes. Ces métriques n'étaient pas disponibles dans YouTube Studio. Cette modification permet donc d'aligner les fonctionnalités de l'API sur celles disponibles dans l'application Studio.
    • Les dimensions subscribedStatus et youtubeProduct ne sont plus acceptées comme filtres pour les rapports sur les playlists de chaînes. Ces filtres n'étaient pas disponibles dans YouTube Studio. Cette modification aligne donc les fonctionnalités de l'API sur celles disponibles dans l'application Studio.

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

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

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

  • Le comportement de la métrique views dépend désormais de l'utilisation ou non de la dimension isCurated par la requête API qui a récupéré le rapport sur la playlist :

    • Lorsqu'une requête inclut la dimension isCurated, la métrique views est une métrique de playlist qui indique le nombre de fois où les vidéos ont été visionnées dans le contexte des playlists de la chaîne.
    • Lorsqu'une requête n'inclut pas la dimension isCurated, la métrique views est une métrique vidéo agrégée qui spécifie le nombre total de fois où les vidéos des playlists de la chaîne ont été visionnées, que ces vues aient eu lieu ou non dans le contexte de la playlist. Le total agrégé n'inclut que les vues des 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ù les vidéos ont été visionnées dans le contexte de la playlist. Cette métrique comptabilise les vues de toutes les vidéos de la playlist, quelle que soit la chaîne à laquelle elles appartiennent.

  • Pour chaque rapport sur les playlists, la documentation sur les rapports sur les chaînes inclut désormais des tableaux indiquant les métriques compatibles avec ce rapport, selon que la requête API inclut ou non la dimension isCurated. Pour obtenir un exemple, consultez la section définissant les rapports sur les playlists basés sur le temps.

4 décembre 2023

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

15 décembre 2022

L'API YouTube Analytics (requêtes ciblées) est compatible avec deux nouvelles dimensions et un nouveau rapport :

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

  • La nouvelle dimension creatorContentType identifie le type de contenu YouTube associé aux métriques d'activité 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 vidéo sur les chaînes et les propriétaires de contenu.

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

  • Les références aux dimensions 7DayTotals et 30DayTotals ont été supprimées de la documentation. L'abandon de ces dimensions a été annoncé en octobre 2019.

26 août 2022

L'API YouTube Analytics (requêtes ciblées) et l'API YouTube Reporting (rapports groupés) sont toutes deux compatibles avec une nouvelle valeur de détail de la source de trafic :

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

11 février 2022

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

Voici les modifications apportées :

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

9 février 2022

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

2 février 2022

L'API YouTube Reporting (rapports groupés) est compatible avec une nouvelle valeur de dimension "Source de trafic" qui indique que les vues proviennent de Live Redirects :

  • Dans l'API YouTube Reporting (rapports groupés), la dimension traffic_source_type accepte la valeur 28.

Pour ce type de source de trafic, la dimension traffic_source_detail spécifie l'ID de la chaîne d'où provient le spectateur.

23 septembre 2020

L'API YouTube Analytics (requêtes ciblées) et l'API YouTube Reporting (rapports groupés) sont toutes deux compatibles avec une nouvelle valeur de dimension Source de trafic. Celle-ci indique que le spectateur a été redirigé en balayant l'écran verticalement dans l'expérience de visionnage des Shorts YouTube :

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

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

20 juillet 2020

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

  • La taille maximale d'un groupe de rapports YouTube Analytics est passée de 200 à 500 entités.
  • Le paramètre filters de la méthode reports.query identifie une liste de filtres à appliquer lors de la récupération des données YouTube Analytics. Le paramètre permet de spécifier plusieurs valeurs pour les filtres video, playlist et channel. Le nombre maximal d'ID pouvant être spécifiés pour ces filtres est passé de 200 à 500.

13 février 2020

Cette mise à jour inclut les modifications suivantes concernant l'API YouTube Analytics (requêtes ciblées) et l'API YouTube Reporting (rapports groupés). Pour en savoir plus sur ces modifications, consultez le Centre d'aide YouTube.

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

Les nouvelles valeurs divisent les notifications liées aux vidéos mises en ligne et aux diffusions en direct, précédemment signalées comme uploaded, en deux catégories :

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

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

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

15 octobre 2019

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

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

    YouTube supprime la compatibilité avec les dimensions 7DayTotals et 30DayTotals. Vous pourrez continuer à récupérer des données à l'aide de ces dimensions jusqu'au 15 avril 2020. À partir 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 interrogeant la dimension day et en agrégeant ou en dérivant les données sur des périodes de 7 ou 30 jours. Exemple :

    • Le nombre de vues pour une période de sept jours peut être calculé en agrégeant le nombre de vues de chaque jour de cette période.
    • Pour calculer le viewerPercentage sur une période de sept jours, multipliez le nombre de vues enregistrées chaque jour par le viewerPercentage de ce jour. Vous obtiendrez ainsi le nombre de spectateurs connectés qui ont regardé la vidéo ce jour-là. Ensuite, le nombre de spectateurs connectés peut être ajouté pour l'ensemble de la période et divisé par le nombre total de vues pour cette période afin d'obtenir la valeur "viewerPercentage" pour l'ensemble de la période.
    • Le nombre de spectateurs uniques sur une période de sept jours ne peut pas être calculé, car un même spectateur peut être comptabilisé comme spectateur unique sur plusieurs jours. Toutefois, vous pouvez utiliser la dimension month au lieu de la dimension 30DayTotals pour extrapoler les données sur le nombre de spectateurs uniques sur une période de 30 jours. Notez que la dimension month fait référence aux mois calendaires, tandis que la dimension 30DayTotals calcule 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 pour 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 de cet abandon a été annoncé initialement 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 Anonymisation des données du document de présentation du modèle de données explique que certaines données YouTube Analytics sont limitées lorsque les métriques n'atteignent pas un certain seuil. Cela peut se produire dans différents cas. En pratique, cela signifie qu'un rapport peut ne pas contenir toutes vos données (ou aucune d'entre elles) si :

    1. une vidéo ou une chaîne enregistre un trafic limité pendant une période donnée ;

      ou

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

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

  • Les documents Rapports sur les chaînes et Rapports sur les propriétaires de contenu ont été mis à jour pour indiquer que les métriques redViews et estimatedRedMinutesWatched ne sont plus disponibles pour les rapports sur les zones de lecture, les sources de trafic, et les types d'appareils/systèmes d'exploitation.

18 juin 2018

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

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

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

23 mai 2018

Cette mise à jour inclut les modifications suivantes 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 gèrent les données associées aux ressources supprimées, telles que les vidéos, les playlists ou les chaînes.
  • La section Bonnes pratiques de la présentation de l'API a été mise à jour pour vous rappeler que vous pouvez utiliser l'API YouTube Data afin de 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 les Règles du développeur des services d'API YouTube (sections III.E.4.b à III.E.4.d), les clients API doivent supprimer ou actualiser les métadonnées de ressources stockées à partir de cette API après 30 jours.

22 mai 2018

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

  • Les modifications suivantes devraient entrer en vigueur en juillet 2018. Les nouvelles règles s'appliqueront à l'ensemble des rapports et des jobs de création de rapports.

    • Après ce changement, la plupart des rapports d'API, y compris les rapports de backfill, seront disponibles pendant 60 jours à compter de leur génération. Toutefois, les rapports contenant des données historiques seront 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. Pour être clair, lorsque ce changement de règlement 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. La documentation indique désormais que les rapports créés avant la modification du règlement seront disponibles pendant 180 jours.

    • Après la modification, lorsque vous planifierez une tâche de création de rapports, YouTube générera des rapports à partir de ce jour et pour la période de 30 jours précédant la date 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 la date 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 afin de récupérer des métadonnées supplémentaires pour les ressources identifiées dans les rapports. Comme indiqué dans les Règles du développeur des services d'API YouTube (sections III.E.4.b à III.E.4.d), les clients API doivent supprimer ou actualiser les métadonnées de ressources stockées à partir de cette API après 30 jours.

  • La section Caractéristiques des rapports a été mise à jour pour indiquer que même si les données des rapports ne sont pas filtrées, les rapports contenant des données pour une période à compter du 1er juin 2018 n'incluront aucune référence aux 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 un nouveau job de reporting, les rapports historiques sont généralement publiés sous quelques jours. Auparavant, la documentation indiquait que la disponibilité de ces rapports pouvait prendre jusqu'à 30 jours.

  • La section Données de backfill de la présentation de l'API a été mise à jour pour définir plus clairement les données de backfill comme un ensemble de données qui remplace un ensemble précédemment fourni.

26 avril 2018

La version 2 de l'API YouTube Analytics (requêtes ciblées) est désormais disponible publiquement. La liste suivante identifie les modifications apportées au produit et à la documentation concernant la nouvelle version de l'API :

  • L'API v2 est presque identique à l'API v1. Toutefois, vous devrez probablement mettre à jour votre code pour refléter les modifications listé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.
    • Plusieurs paramètres de la méthode reports.query ont été renommés. Plus précisément, les noms de paramètres contenant des traits d'union, comme end-date dans l'API v1, utilisent la casse camelCase (endDate) plutôt que des traits d'union dans l'API v2. Cette modification permet d'harmoniser les noms des paramètres dans l'API, car les méthodes de l'API pour créer et gérer des groupes utilisaient déjà le camelCase 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.

    De plus, certaines fonctionnalités de la v1 ne sont pas compatibles avec l'API v2 :

    • La méthode reports.query n'accepte plus les paramètres de requête alt, quotaUser et userIp.
    • L'API v2 ne fournit pas de point de terminaison par lot compatible avec les lots composés de requêtes adressées à différentes API. (Un lot peut toutefois être composé de requêtes adressées à différentes méthodes de la même API.) Cette obsolescence n'est pas spécifique à l'API YouTube Analytics, car Google abandonne le point de terminaison par lot global pour toutes ses API.
    • L'API v2 n'est pas compatible avec le protocole JSON-RPC, qui était compatible avec l'API v1. Encore une fois, cette obsolescence n'est pas spécifique à l'API YouTube Analytics.

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

    La version 1 de l'API (v1) est désormais obsolète et sera 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, veillez à passer à la version 2 de l'API d'ici le 31 octobre 2018 pour éviter toute interruption de l'accès aux données YouTube Analytics via l'API.

21 février 2018

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

  • Les rapports sur les données démographiques des spectateurs, qui regroupent les statistiques de visionnage en fonction de la tranche d'âge et du genre des spectateurs, 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 :
      • 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 est désormais compatible avec la compression gzip pour les requêtes qui téléchargent des rapports. Notez que la compression gzip n'est pas compatible avec les autres types de requêtes API. L'activation de la compression gzip réduit la bande passante requise pour chaque réponse de l'API. Même si votre application aura besoin d'un temps CPU supplémentaire pour décompresser les réponses de l'API, l'avantage de consommer moins de ressources réseau l'emporte généralement sur ce coût.

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

    • Les valeurs de la dimension age_group utilisent des lettres majuscules, contiennent des traits de soulignement entre le mot AGE et les chiffres de la tranche d'âge, et utilisent des traits de soulignement au lieu de traits d'union. Par conséquent, les valeurs telles que age13-17 et age18-24 ont été corrigées en AGE_13_17 et AGE_18_24, respectivement.
    • Les valeurs de la dimension gender sont en majuscules. Ainsi, les valeurs female, male et gender_other ont été corrigées en FEMALE, MALE et GENDER_OTHER.

10 août 2017

Le 10 août 2016, cette documentation a annoncé l'abandon de la métrique earnings de l'API YouTube Analytics. (En même temps, l'API a ajouté la compatibilité avec une nouvelle métrique, nommée estimatedRevenue, qui fournit les mêmes données.)

La métrique earnings étant une métrique principale, elle a été prise en charge pendant un an à compter de la date de l'annonce. Cette période d'un an étant terminée, la métrique earnings n'est plus disponible. 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 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 indiquer que les réponses de l'API contiennent des données jusqu'au dernier jour de la plage de dates demandée pour lequel toutes les métriques interrogées sont disponibles.

      Par exemple, si une requête spécifie une date de fin au 5 juillet 2017 et que les valeurs de toutes les métriques demandées ne sont disponibles que jusqu'au 3 juillet 2017, cette dernière date sera la dernière pour laquelle les données seront incluses dans la réponse. (Cela est vrai même si les données de certaines des métriques demandées sont disponibles pour 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 de six secondes maximum diffusée avant qu'une vidéo puisse être visionnée. Le format d'annonce est identique à celui de l'annonce auctionBumperInstream, mais ce type fait référence aux annonces vendues par réservation plutôt que par 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 sur réservation. Les annonces bumper sont des annonces vidéo non désactivables de six secondes maximum qui sont diffusées avant qu'une vidéo puisse être visionnée. Notez que la valeur 19 de cette dimension fait également référence aux annonces bumper vendues via des enchères plutôt que par réservation.

    • Les jobs de création de rapports pour les rapports de l'API YouTube Reporting suivants ont été supprimés :

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

      Ces types de rapports ont été annoncés comme obsolètes le 15 septembre 2016 et n'ont plus été générés après le 15 décembre 2016. Les rapports générés précédemment sont restés disponibles pendant 180 jours à compter de leur génération. Par conséquent, certains rapports étaient accessibles jusqu'au 15 juin 2017. Toutefois, comme les rapports ne sont plus disponibles, les jobs associés ne sont plus nécessaires non plus.

24 mai 2017

Tous les jobs de création de rapports pour les rapports de l'API YouTube Reporting suivants ont été supprimés :

  • 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, et les rapports n'ont plus été générés pour ces types de rapports après le 22 septembre 2016. Les rapports générés précédemment sont restés disponibles pendant 180 jours à compter de leur génération. Par conséquent, certains rapports étaient accessibles jusqu'au 22 mars 2017. Toutefois, comme les rapports ne sont plus disponibles, les jobs associés ne sont plus nécessaires non plus.

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é modifié dans la documentation et remplacé par Kakao (Kakao Talk) afin de mieux le différencier de la valeur 73 (Kakao Story). Cette modification ne reflète aucun changement dans le comportement de l'API ni dans 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 peuvent accéder aux données sur les revenus via YouTube Analytics dans Creator Studio peuvent désormais également accéder à ces données 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 sont toutes deux liées au nombre de spectateurs YouTube Red. En fait, l'API est 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 des membres YouTube Red.
    • La métrique estimatedRedMinutesWatched indique le nombre de minutes pendant lesquelles les membres YouTube Red ont regardé une vidéo.

    La documentation sur les rapports sur les chaînes et les rapports sur les propriétaires de contenu a été mise à jour pour indiquer quels rapports sont compatibles avec les deux nouvelles métriques. Elles sont compatibles avec tous les rapports qui acceptaient déjà les métriques views et estimatedMinutesWatched.

3 mars 2017

Cette mise à jour inclut les changements suivants :

  • API YouTube Reporting (rapports groupés)

    • La définition de la dimension date a été corrigée pour indiquer que 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 auxquelles les horloges sont avancées représentent une période de 23 heures, et les dates auxquelles les horloges sont reculées représentent une période de 25 heures. (Auparavant, la documentation indiquait que chaque date représentait une période unique de 24 heures et que l'heure du Pacifique était toujours UTC-8.)

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

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

    • 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 a été complètement abandonné le 19 août 2016, mais les rapports content_owner_basic_a1 générés précédemment sont restés disponibles pendant 180 jours à compter de leur génération. Par conséquent, certains rapports étaient accessibles jusqu'au 19 février 2017. Toutefois, comme les rapports ne sont plus disponibles, les jobs associés ne sont plus nécessaires non plus.

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

    • La description des dimensions liées à time periods a été corrigée pour indiquer que la valeur de la dimension fait référence à la période 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 auxquelles les horloges sont avancées représentent une période de 23 heures, et les dates auxquelles les horloges sont reculées 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'un jour ne représente pas une période de 24 heures.)

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

    • La documentation sur les rapports sur les canaux a été mise à jour pour indiquer que ces rapports ne contiennent actuellement pas de métriques sur les revenus ni sur les performances des annonces. Par conséquent, le niveau d'accès https://www.googleapis.com/auth/yt-analytics-monetary.readonly ne permet pas d'accéder aux données monétaires dans les rapports sur les chaînes.

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

8 février 2017

L'API YouTube Analytics accepte désormais le paramètre facultatif include-historical-channel-data. Notez que ce paramètre n'est pertinent que lors de la récupération des rapports du propriétaire de contenu.

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

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

  • Si la valeur du paramètre est false, les données de durée de visionnage et de vues renvoyées pour une chaîne donnée sont basées sur la date à laquelle cette chaîne a été associée au propriétaire de contenu.

    Il est important de se rappeler que différentes chaînes peuvent avoir été associées à un propriétaire de contenu à 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 les données de durée de visionnage et de vues 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 de l'API YouTube Reporting suivants ne sont plus acceptés et ont été supprimés de la documentation. Une version plus récente de chaque rapport est disponible. (L'annonce de l'abandon de ces rapports a été faite le 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 qu'avec de nouvelles dimensions et métriques pour ces rapports. Les rapports fournissent des statistiques sur les impressions et les clics pour les écrans de fin qui s'affichent après la lecture d'une vidéo.

  • Rapports sur les écrans de fin

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

  • Dimensions de l'écran de fin

  • Métriques sur les écrans de fin

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

    • Le Centre d'aide YouTube contient des informations plus détaillées sur l'ajout d'écrans de fin à vos vidéos.

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

8 novembre 2016

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

  • Les métriques de la liste suivante sont entièrement obsolètes et ne sont plus acceptées. Comme annoncé le 10 août 2016, de nouvelles métriques faisant référence aux mêmes données sont déjà disponibles. Le tableau ci-dessous indique le nom de la métrique obsolète et le nom de la nouvelle métrique :

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

27 octobre 2016

YouTube génère désormais automatiquement un ensemble de rapports sur les revenus publicitaires gérés par le système pour les propriétaires de contenu qui ont accès aux rapports correspondants dans la section Rapports de YouTube Creator Studio. Les nouveaux rapports d'API gérés 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 fournit un bref aperçu des nouveaux rapports et explique comment les récupérer via l'API. Ce processus est légèrement différent de celui permettant de récupérer des rapports groupés pour YouTube Analytics, car les partenaires n'ont pas besoin de planifier des jobs 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 par vidéo dans le monde
  • Revenu publicitaire quotidien par vidéo et par pays
  • Revenus publicitaires mensuels par élément dans le monde entier
  • Revenus publicitaires quotidiens par pays et par élément
  • Revendications (ce rapport ne contient pas de données sur les revenus)

27 septembre 2016

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

La métrique uniques de l'API YouTube Analytics est obsolète. Il ne s'agit pas d'une métrique principale. Elle sera prise en charge 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 inclut la modification suivante de 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 nouveaux rapports de ce type, mais ceux qui ont déjà été générés resteront disponibles pendant 180 jours à compter de leur date de génération.

    Le rapport content_owner_basic_a1 est remplacé par 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 API YouTube (les "Conditions d'utilisation mises à jour"), présentées en détail sur le blog YouTube Engineering and Developers, apportent de nombreuses modifications aux Conditions d'utilisation actuelles. En plus des Conditions mises à jour, qui entreront en vigueur le 10 février 2017, cette mise à jour inclut plusieurs documents d'accompagnement pour expliquer les règles que les développeurs doivent suivre.

    L'ensemble des nouveaux documents est décrit dans l'historique des révisions des Conditions d'utilisation mises à jour. De plus, les modifications futures apportées aux Conditions mises à jour ou à ces documents d'accompagnement seront également expliquées dans cet historique des révisions.

10 août 2016

Cette mise à jour inclut les modifications suivantes :

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

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

      Les métriques du tableau suivant sont obsolètes. En parallèle, de nouvelles métriques faisant référence aux mêmes données sont introduites. En effet, cela signifie que les anciennes métriques sont 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 de compatibilité
      earnings estimatedRevenue 10 août 2017
      adEarnings estimatedAdRevenue 4 novembre 2016
      redPartnerRevenue estimatedRedPartnerRevenue 4 novembre 2016
      impressionBasedCpm cpm 4 novembre 2016
      impressions adImpressions 4 novembre 2016

      Notez que la métrique earnings était une métrique principale. Elle sera donc prise en charge pendant un an à compter de la date de cette annonce. Les autres métriques, qui n'étaient pas des métriques principales, seront acceptées pendant trois mois, jusqu'au 4 novembre 2016.

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

    • La dimension insightTrafficSourceType accepte deux nouvelles valeurs de dimension :
      • CAMPAIGN_CARD : cette source de trafic n'est disponible que pour les rapports sur les propriétaires de contenu. Cela indique que les vues proviennent de vidéos revendiquées et mises en ligne par des utilisateurs, que le propriétaire de contenu a utilisées pour promouvoir le contenu visionné.
      • 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 récupérer un rapport traffic source detail. Dans les deux cas, la dimension insightTrafficSourceDetail identifie la vidéo à partir de laquelle le spectateur a été redirigé.

    • La dimension adType accepte désormais la valeur auctionBumperInstream, qui fait référence à une annonce vidéo non désactivable de six secondes maximum diffusée avant qu'une vidéo puisse être visionnée.

  • API YouTube Reporting (rapports groupés)

    • La dimension traffic_source_type accepte désormais les valeurs suivantes :
      • 19 : cette source de trafic n'est disponible que pour les rapports sur les propriétaires de contenu. Cela indique que les vues proviennent de vidéos revendiquées et mises en ligne par des utilisateurs, que le propriétaire de contenu a utilisées pour promouvoir le contenu visionné.
      • 20 : les données concernent les vues provenant de l'écran de fin d'une autre vidéo.

      Pour les deux nouvelles sources de trafic, la dimension traffic_source_detail identifie la vidéo à partir de laquelle le spectateur a été redirigé.

    • La liste des métriques principales de l'API a été corrigée pour inclure estimated_partner_revenue et supprimer earnings. (La métrique earnings n'a jamais été compatible avec l'API YouTube Reporting.)

    • La dimension ad_type accepte désormais la valeur 19, qui fait référence aux annonces bumper. Il s'agit d'annonces vidéo non désactivables de six secondes maximum qui sont diffusées 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 des métriques compatibles avec les rapports sur les canaux suivants ont été mises à jour pour inclure les métriques des fiches. La prise en charge des métriques des fiches dans ces rapports a été ajoutée le 28 juin 2016. L'historique des révisions pour cette date explique ce changement plus en détail. Voici les rapports :
      • Activité de base des utilisateurs pour les États américains
      • Activité des utilisateurs dans les États américains pour des périodes spécifiques
      • Activité des utilisateurs par province
      • Activité des utilisateurs par état d'abonnement
      • Activité des utilisateurs par état d'abonnement pour les provinces
      • Top des vidéos par état
      • Vidéos les plus regardées par les spectateurs abonnés ou non abonnés

    • Les listes de filtres ont été corrigées pour les rapports sur la rétention d'audience des chaînes et 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 accepté.

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

  • 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 pour les jours où aucune donnée n'était disponible. Ces rapports contiennent une ligne d'en-tête, mais pas de données supplémentaires. Ces informations avaient déjà été mises à jour dans la section Caractéristiques du rapport du même document le 12 avril 2016.
    • La liste des dimensions du rapport content_owner_asset_cards_a1 a été corrigée pour indiquer que le rapport utilise la dimension card_id. Auparavant, la documentation indiquait par erreur que le nom de la dimension était card_title.

28 juin 2016

La documentation de l'API YouTube Analytics a été mise à jour pour refléter 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 compatibles avec 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, et les autres n'affectent que les rapports des propriétaires de contenu :

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

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

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

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

    • Deux rapports dont de nouvelles versions sont disponibles ont été renommés :

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

      Les deux rapports renommés diffèrent de leurs prédécesseurs de la manière suivante :

    Notez que si vous avez déjà des jobs pour créer les anciennes versions de ces rapports, vous devez en créer de nouveaux 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 vous avez des jobs pour l'un de ces rapports, YouTube ne générera pas de nouveaux rapports pour ces jobs après le 22 septembre 2016. Les rapports générés resteront disponibles pendant 180 jours à compter de leur date de génération.

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

  • Les noms de deux métriques ont été corrigés dans la documentation pour correspondre à ceux qui apparaissent dans les rapports. Il s'agit d'une simple correction de la documentation, qui ne reflète pas un changement du 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 sont abandonnés avec cette mise à jour. Comme décrit ci-dessus, cette métrique a été renommée estimated_partner_ad_auction_revenue dans les versions plus récentes de ces rapports.
    • La métrique estimated_partner_doubleclick_revenue a été renommée estimated_partner_double_click_revenue. Encore une fois, notez que cette métrique n'apparaît que dans deux rapports qui sont abandonnés avec cette mise à jour. Comme décrit ci-dessus, cette métrique a été renommée estimated_partner_ad_reserved_revenue dans les versions plus récentes de ces rapports.

  • La documentation sur les dimensions de l'API Reporting a été mise à jour et ne liste plus les propriétés elapsed_video_time_percentage et audience_retention_type. Ces dimensions ne sont actuellement compatibles avec aucun rapport disponible 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 nouveau type de 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à un job pour créer le rapport content_owner_basic_a1, vous devez quand même créer un job pour le rapport content_owner_basic_a2. YouTube ne migre pas automatiquement les propriétaires de contenu vers la nouvelle version du rapport et ne crée pas automatiquement de 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 sortie du nouveau rapport, le rapport content_owner_basic_a1 a été abandonné. Si vous avez un job pour ce rapport, YouTube ne générera plus de nouveaux rapports pour ce job après le 19 août 2016. Les rapports générés resteront disponibles pendant 180 jours à compter de leur date de génération.

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

    • La propriété deprecateTime de la ressource reportType spécifie la date et l'heure auxquelles le type de rapport sera abandonné. Cette propriété n'a de valeur que pour les rapports qui ont été annoncés comme obsolètes. La valeur représente la date à laquelle YouTube cessera de générer des rapports de ce type.

      Une fois qu'un type de rapport est annoncé comme obsolète, YouTube génère des rapports de ce type pendant trois mois supplémentaires. Par exemple, cette mise à jour du 19 mai 2016 annonce l'abandon du rapport content_owner_basic_a1. Ainsi, le champ deprecateTime pour ce type de rapport spécifie une heure le 19 août 2016, après laquelle YouTube cessera de générer des rapports de ce type.

    • La propriété expireTime de la ressource job spécifie la date et l'heure d'expiration du job. Cette propriété a une valeur si le type de rapport associé au job est obsolète ou si les rapports générés pour le job n'ont pas été téléchargés pendant une période prolongée. Cette date correspond au moment à partir duquel YouTube ne génère plus de rapports pour le job.

    • La propriété jobExpireTime de la ressource report spécifie la date et l'heure auxquelles le job associé au rapport a expiré ou expirera. Cette propriété contient la même valeur que la propriété expireTime de la 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 un job pour un rapport obsolète. De plus, la documentation de la méthode liste désormais plusieurs autres raisons pour lesquelles une requête API peut échouer.

12 avril 2016

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

  • YouTube génère désormais des données couvrant la période de 180 jours précédant la première planification d'un job de reporting. Auparavant, l'API Reporting ne fournissait aucune donnée historique. Ce changement affecte tous les jobs, y compris ceux créés avant cette annonce.

    Les rapports historiques sont publiés dès qu'ils sont disponibles, mais il faut environ un mois pour que toutes les données historiques soient publiées pour un job. Ainsi, un mois après avoir planifié un job de reporting, 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 un délai d'un mois à compter de l'annonce.)

    Notez que les données historiques ne sont disponibles qu'à partir du 1er juillet 2015. Par conséquent, les jobs créés avant le 28 décembre 2015 disposeront de 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 des rapports de la présentation de l'API YouTube Reporting a été mise à jour avec les modifications suivantes :

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

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

    Les modifications suivantes apportées à l'API sont annoncées dès maintenant en prévision du lancement des rapports gérés par le système :

    • La nouvelle propriété systemManaged de la ressource job indique si la ressource décrit un job 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. Ces derniers ne peuvent pas modifier ni supprimer les jobs 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 les jobs pour les rapports gérés par le système. La valeur par défaut du paramètre est false.

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

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

    • La nouvelle propriété systemManaged de la 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 les rapports gérés par le système. La valeur par défaut du paramètre est false.

28 mars 2016

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

  • Dans l'API YouTube Reporting, la dimension sharing_service accepte les nouvelles valeurs suivantes :
    • 82 : boîte de dialogue d'activité du système iOS
    • 83 : Google Inbox
    • 84 : Android Messenger
  • Dans l'API YouTube Analytics, la dimension sharingService accepte les nouvelles valeurs suivantes :
    • ANDROID_MESSENGER : Android Messenger
    • INBOX : Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG : boîte de dialogue 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 :
    • 7 : les données concernent les vues enregistrées sur la page d'accueil YouTube ou l'écran d'accueil, dans le flux d'abonnements de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.
    • 8 : les données concernent les vues qui ont eu lieu directement sur la page de résultats de recherche YouTube.
  • La dimension traffic_source_type accepte désormais 18 comme valeur de dimension. Cette valeur indique que les vues de la vidéo proviennent d'une page qui liste toutes les vidéos d'une playlist. Cette source diffère du type de source 14, qui indique que les vues ont été enregistrées lorsque la vidéo était lue dans une playlist.

API YouTube Analytics

  • La dimension insightPlaybackLocationType accepte deux nouvelles valeurs de dimension :
    • BROWSE : les données concernent les vues enregistrées sur la page d'accueil YouTube ou l'écran d'accueil, dans le flux d'abonnements de l'utilisateur ou dans une autre fonctionnalité de navigation YouTube.
    • SEARCH : les données concernent les vues qui ont eu lieu directement sur la page de résultats de recherche YouTube.
  • La dimension insightTrafficSourceType accepte désormais YT_PLAYLIST_PAGE comme valeur de dimension. Cette valeur indique que les vues de la vidéo proviennent d'une page qui liste toutes les vidéos d'une playlist. Cette source diffère du type de source PLAYLIST, qui indique que les vues ont été enregistrées pendant la lecture de la vidéo dans une playlist.

8 février 2016

La liste des métriques compatibles avec l'API YouTube Analytics a été mise à jour. Les métriques des fiches ne sont plus listées comme compatibles avec cette API. (Aucun des rapports de cette API n'était documenté comme étant compatible avec l'une des métriques de la fiche.)

Notez que vous pouvez toujours récupérer les métriques des fiches à l'aide de l'API YouTube Reporting, qui prend en charge 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 spécifiquement 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 qui ont lieu via Chromecast.
  • Dans l'API YouTube Analytics, la dimension operatingSystem utilise la valeur CHROMECAST pour identifier les vues qui ont lieu via Chromecast.

21 décembre 2015

Dans la documentation, les noms des métriques annotation_clickable_impressions et annotation_closable_impressions ont été mis à jour pour correspondre aux noms renvoyés dans les rapports. Auparavant, les noms étaient documentés comme clickable_annotation_impressions et closable_annotation_impressions.

18 décembre 2015

Conformément à la législation de l'Union européenne (UE), vous devez publier certaines informations à l'attention des utilisateurs finaux et obtenir leur consentement. Par conséquent, pour les utilisateurs finaux de l'Union européenne, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE. Nous avons ajouté un avis concernant cette exigence dans nos Conditions d'utilisation des API YouTube.

15 décembre 2015

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

  • L'API YouTube Analytics est désormais compatible avec trois nouvelles dimensions de détails de lecture, qui peuvent être utilisées dans différents rapports sur les chaînes et les propriétaires de contenu :

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

    La documentation a été mise à jour pour identifier les nouveaux rapports détaillés sur la lecture disponibles pour les chaînes et les propriétaires de contenu. De plus, 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 pouvant être utilisées pour récupérer chaque rapport. Le tableau suivant, qui explique le rapport "Type d'appareil" pour les chaînes, présente le nouveau format :

    Propriété Valeur
    Dimensions :
    Obligatoire deviceType
    Utilisez une valeur supérieure ou égale à 0 day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Métriques :
    Utilisez-en un ou plusieurs views, estimatedMinutesWatched
    Filtres :
    Utilisez 0 ou 1. country, province, continent, subContinent
    Utilisez 0 ou 1. vidéo, groupe
    Utilisez une valeur supérieure ou égale à 0 operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

  • L'API YouTube Analytics supprime désormais automatiquement les entités pour lesquelles l'utilisateur de l'API ne peut pas récupérer de données à partir de filtres acceptant plusieurs valeurs (video, playlist et channel). Auparavant, le serveur d'API renvoyait simplement une erreur si l'utilisateur de l'API ne pouvait pas accéder aux données d'au moins l'un des éléments spécifiés.

    Par exemple, supposons qu'un utilisateur envoie une requête API dans laquelle le filtre video liste 20 ID vidéo. L'utilisateur est propriétaire de 18 vidéos. Cependant, l'un des ID vidéo identifie une vidéo appartenant à une autre chaîne, et un autre ID identifie une vidéo qui a été supprimée et qui n'existe donc plus. Dans ce cas, au lieu de renvoyer une erreur, le serveur d'API supprime les deux vidéos auxquelles l'utilisateur n'a pas accès, et la réponse de l'API contient les données des 18 vidéos appartenant à l'utilisateur de l'API.

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

  • La méthode groupItems.insert de l'API YouTube Analytics renvoie désormais une erreur "Non autorisé" (code de réponse HTTP 403) si vous essayez d'ajouter une entité à un groupe, mais que vous n'avez pas accès à cette entité. Auparavant, l'API vous aurait permis d'ajouter l'entité au groupe, mais aurait ensuite renvoyé une erreur d'autorisation lorsque vous auriez essayé 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 qui peut ê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 de la dimension date de l'API YouTube Reporting a été corrigée pour indiquer que les dates font référence à la période de 24 heures commençant à minuit, heure du Pacifique (UTC-8). Auparavant, la documentation indiquait que la date commençait à minuit (GMT).

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

  • La méthode jobs.reports.list() de l'API YouTube Reporting accepte désormais le paramètre de requête createdAfter. S'il est spécifié, ce paramètre indique que la réponse de l'API ne doit lister que les rapports créés après la date et l'heure spécifiées, y compris les nouveaux rapports contenant des données de backfill. Notez que la valeur du paramètre correspond à l'heure de création du rapport, et non aux dates associées aux données renvoyées.

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

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

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

8 octobre 2015

Cette mise à jour inclut les changements suivants :

  • La documentation de la dimension sharingService de l'API YouTube Analytics a été mise à jour pour inclure une liste des valeurs de dimension possibles. La liste inclut 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 lister 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 de données 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 explorer ces données.

    Chaque rapport de l'API YouTube Reporting contient un ensemble prédéfini de dimensions et de métriques. (Les rapports de l'API YouTube Analytics utilisent également des métriques et des dimensions.) Dans un rapport, chaque ligne de données présente une combinaison unique de valeurs de dimension. Vous pouvez agréger les données de plusieurs lignes en fonction des valeurs de dimension pour 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 jobs de création de rapports, chacun identifiant un rapport que YouTube doit générer. Une fois que vous avez configuré un job, YouTube génère un rapport quotidien qui peut être téléchargé de manière asynchrone. Chaque rapport contient des données pour une période unique de 24 heures.

  • Bien qu'il s'agisse d'API différentes, l'API YouTube Analytics et l'API YouTube Reporting permettent toutes deux aux développeurs de récupérer 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 seul ensemble de documentation.

    • L'onglet Guides de la documentation contient des informations communes aux deux API, y compris des instructions pour autoriser les requêtes API.
    • L'onglet Rapports groupés contient la documentation de référence et d'autres contenus spécifiques à l'API YouTube Reporting.
    • L'onglet Requêtes ciblées contient la documentation de référence et d'autres contenus spécifiques à l'API YouTube Analytics.
    • L'onglet Exemples liste les exemples de code disponibles pour l'une ou l'autre des deux API.
    • L'onglet Outils liste 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 la compréhension de l'API. Par conséquent, ces modifications ne décrivent pas de nouvelles fonctionnalités :

    • La documentation contient désormais une page qui liste tous les rapports sur les chaînes disponibles et une autre qui 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 la chaîne, les rapports sur les playlists de la chaîne, etc.

    • La nouvelle présentation du modèle de données vise à fournir une introduction plus claire au fonctionnement de l'API. Plus précisément, ce document tente 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 les rapports, est désormais documentée séparément. Les informations de cette page se trouvaient auparavant sur d'autres pages. La 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 inclut 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 publicitaires vendues par Google. Il ne s'agit pas d'une métrique principale. L'API est compatible avec la métrique adEarnings pour tous les rapports qui étaient déjà compatibles avec la métrique earnings.

    De plus, la définition de la métrique earnings a été corrigée pour 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 provenant de sources publicitaires.

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

  • En plus de la métrique primaryAdGrossRevenue obsolète, les rapports sur les performances des annonces n'acceptent plus les métriques monetizedPlaybacks et playbackBasedCpm. Toutefois, plusieurs rapports vidéo sont toujours compatibles avec 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 vidéo : videosAddedToPlaylists et videosRemovedFromPlaylists. Les listes de rapports vidéo pour les chaînes et les propriétaires de contenu ont toutes deux été mises à jour pour identifier les rapports compatibles avec les nouvelles métriques.

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

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

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

31 mars 2015

Cette mise à jour inclut les changements suivants :

16 mars 2015

Cette mise à jour inclut les changements suivants :

  • Le nouveau paramètre currency vous permet de récupérer les métriques de revenus dans une devise autre que le dollar américain (USD). Si le paramètre est défini, l'API convertit les valeurs des métriques earnings, grossRevenue, playbackBasedCpm et impressionBasedCpm dans la devise spécifiée. Les valeurs renvoyées sont des estimations calculées à l'aide de taux de change qui varient 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 permet désormais de créer et de gérer des groupes YouTube Analytics, ainsi que 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, une collection personnalisée de 200 chaînes, vidéos, playlists ou éléments au maximum. 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 est compatible avec les méthodes list, insert et delete pour cette ressource.

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

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

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

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

13 février 2015

Cette mise à jour inclut les changements suivants :

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

28 août 2014

Cette mise à jour inclut les changements suivants :

  • L'API permet désormais de spécifier plusieurs valeurs pour les dimensions video, playlist, channel et show lorsqu'elles sont utilisées comme filtres. Pour spécifier plusieurs valeurs, définissez la valeur du paramètre filters sur une liste d'ID de vidéos, de playlists, de chaînes ou d'émissions séparés par une virgule, pour lesquels la réponse de l'API doit être filtrée. La valeur du paramètre peut spécifier jusqu'à 200 ID.

    Si vous spécifiez plusieurs valeurs pour le même filtre, vous pouvez également ajouter ce filtre à la liste des dimensions que vous spécifiez pour la requête. Cela est vrai même si le filtre n'est pas listé comme une dimension compatible pour un rapport particulier. Si vous ajoutez le filtre à la liste des dimensions, l'API utilise également les valeurs de filtre pour regrouper les résultats.

    Pour en savoir plus sur cette fonctionnalité, consultez la définition du paramètre filters.

16 juillet 2014

Cette mise à jour inclut les changements suivants :

  • Lorsque vous récupérez un rapport sur une chaîne, vous pouvez désormais récupérer les données de la chaîne 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 de la chaîne spécifiée.)

  • L'API est désormais compatible avec les rapports sur les playlists, qui contiennent des statistiques sur les vues de vidéos 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 suivantes. Notez que chacune de ces métriques ne reflète que les vues de playlists enregistrées sur le Web.

    • playlistStarts : nombre de lancements d'une playlist par des internautes.
    • viewsPerPlaylistStart : nombre moyen de vues de vidéos enregistrées chaque fois qu'une playlist a été lancée.
    • averageTimeInPlaylist : estimation de la durée moyenne (en minutes) pendant laquelle un spectateur a regardé des vidéos d'une playlist après l'avoir lancée.

    Toute requête visant à récupérer 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 un rapport sur la rétention d'audience. Ce rapport mesure la capacité d'une vidéo à retenir son audience. La nouvelle dimension elapsedVideoTimeRatio du rapport mesure la durée de la vidéo qui s'est écoulée 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 qu'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 visionnée plusieurs fois (ou pas du tout) lors d'un visionnage donné. Par exemple, si les utilisateurs reviennent en arrière et regardent plusieurs fois la même partie d'une vidéo, le ratio absolu de cette partie de la vidéo peut être supérieur à 1.

    • La métrique relativeRetentionPerformance indique la capacité d'une vidéo à retenir l'attention des spectateurs pendant la lecture par rapport à toutes les vidéos YouTube d'une durée similaire. Une valeur de 0 indique que la vidéo retient les spectateurs moins bien que toute autre vidéo de durée similaire, tandis qu'une valeur de 1 indique que la vidéo retient les spectateurs mieux 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 l'autre moitié les retient moins bien.

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

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

    Toutes les nouvelles métriques sont des métriques principales et sont soumises au règlement relatif aux abandons. Toutefois, notez que les données sont disponibles pour les nouvelles métriques à partir du 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é comme une valeur distincte pour la dimension insightTrafficSourceType. À la place, les sites référents provenant des résultats de recherche Google sont désormais attribués au type de source de trafic EXT_URL. Par conséquent, il n'est plus possible de récupérer un rapport insightTrafficSourceDetail qui définit le filtre insightTrafficSourceType sur GOOGLE_SEARCH.

31 janvier 2014

Cette mise à jour inclut les changements suivants :

16 janvier 2014

Cette mise à jour inclut les changements suivants :

  • Le document Exemples de requêtes a été repensé pour regrouper les exemples par catégories, en utilisant un format d'onglet semblable à celui récemment lancé pour les rapports sur les chaînes et les propriétaires de contenu. Avec la nouvelle conception, les exemples sont regroupés dans les catégories suivantes :

    • Statistiques de base
    • Basé sur l'heure
    • Ciblage géographique
    • Contexte de lecture
    • Source de trafic
    • Appareil/OS
    • Catégorie démographique
    • Réseau social
    • Revenus/Annonces (pour les rapports de propriétaires de contenu uniquement)

  • Le document Exemples de requêtes inclut désormais de nouveaux exemples pour récupérer des données spécifiques à une province dans les rapports sur les chaînes ou les rapports sur les propriétaires de contenu.

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

    • Données démographiques des spectateurs en Californie (tranche d'âge et genre) : ce rapport récupère des statistiques sur la tranche d'âge et le genre des spectateurs en Californie qui ont regardé les vidéos d'une chaîne ou, pour les rapports sur les 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 requête doit également limiter les données aux États-Unis en incluant country==US dans la valeur du paramètre filters.

6 janvier 2014

Cette mise à jour inclut les changements suivants :

  • Les documents listant les rapports compatibles sur les chaînes et les propriétaires de contenu ont été repensés. Au lieu de fournir un tableau listant tous les rapports possibles, chaque document regroupe les rapports par catégories :

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

    Chaque document affiche ces catégories sous la forme d'une liste d'onglets. Vous pouvez cliquer sur n'importe quel onglet pour afficher les rapports compatibles 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 Columbia. L'API accepte deux utilisations pour cette dimension :

      • L'API accepte deux rapports qui ventilent 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 la durée de visionnage estimée en minutes.
        • Le rapport basé sur le temps fournit les mêmes statistiques, mais regroupe les données sur une base quotidienne, hebdomadaire, mensuelle ou sur 30 jours.

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

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

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

30 septembre 2013

Cette mise à jour inclut les changements suivants :

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

  • L'API accepte désormais EXTERNAL_APP comme valeur pour la dimension insightPlaybackLocationType. En parallèle de cette mise à jour, depuis le 10 septembre 2013, les lectures ne sont plus classées comme lectures MOBILE, bien que les lectures sur mobile effectuées avant cette date soient 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 ont lieu.

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

  • L'API est désormais compatible avec deux nouvelles dimensions, deviceType et operatingSystem, qui permettent de récupérer des données sur les appareils utilisés par les spectateurs pour regarder vos vidéos. L'API est compatible avec les rapports qui utilisent l'une ou l'autre de ces dimensions, ou les deux.

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

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

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

  • Le document Exemples de requêtes a été mis à jour pour inclure trois rapports sur les appareils pour les chaînes et trois rapports sur les appareils pour les propriétaires de contenu.

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

23 mai 2013

Cette mise à jour inclut les changements suivants :

10 mai 2013

Cette mise à jour inclut les changements suivants :

6 mai 2013

Cette mise à jour inclut les changements suivants :

  • L'API permet désormais de récupérer les métriques de durée de visionnage (estimatedMinutesWatched, averageViewDuration et averageViewPercentage) ainsi que d'autres métriques, y compris les métriques de vues, les métriques d'engagement, les métriques de revenus et les métriques de performances des annonces.

    Les listes des rapports sur les chaînes et des rapports sur les propriétaires de contenu disponibles ont été mises à jour pour refléter ce changement. (Les listes sont en fait plus courtes maintenant, 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 de la manière suivante :

    • Ils sont désormais compatibles avec 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 du contexte de lecture

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

      • Détails de la source de trafic

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

3 mai 2013

Cette mise à jour inclut les changements suivants :

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

  • La dimension insightTrafficSourceType accepte désormais SUBSCRIBER comme valeur valide. Cette valeur identifie les vues de vidéos provenant de flux sur la page d'accueil YouTube ou de fonctionnalités d'abonnement YouTube. Si vous filtrez les données en fonction de cette source de trafic, le champ insightTrafficSourceDetail indique le flux de la page d'accueil ou l'autre 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 de revenus et de performances des annonces, ainsi qu'avec les 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 compatibles prennent en charge les métriques de performances des annonces basées sur la lecture et les métriques de performances des annonces basées sur les impressions. Pour en savoir plus sur les rapports sur les performances des annonces, consultez la documentation sur les rapports pour les propriétaires de contenu.

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

      • earnings : total des revenus estimés de toutes les sources publicitaires vendues par Google.
      • grossRevenue : revenu brut estimé des partenaires Google ou 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 : revenu brut estimé pour mille lectures.
      • impressions : nombre d'impressions d'annonces validées diffusées.
      • impressionBasedCpm : estimation des revenus bruts pour mille impressions d'annonces.

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

    • Toute requête qui récupère des revenus ou des métriques de 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 de manière à ce que les différents types de rapports soient expliqués sur des pages distinctes. Nous avons donc créé des pages distinctes expliquant les différents types de rapports sur les chaînes et de 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 l'APIs Explorer, qui vous permet d'appeler l'API, de voir la requête API et de récupérer des données réelles dans la réponse.

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

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

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

    • Le rapport sur les sources de trafic indique le nombre de vues de vidéos provenant de différents types de sites référents.

    • Le rapport détaillé sur les sources de trafic identifie les sites référents qui ont généré le plus de vues pour une vidéo et un type de source de trafic spécifiques. 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. Les rapports peuvent regrouper les données pour une période spécifique (jour, sept jours précédents, 30 jours précédents, etc.) ou un pays. Si un rapport regroupe les données par jour ou par pays, il peut également indiquer la durée moyenne de chaque visionnage de vidéo, ainsi que le pourcentage moyen de chaque vidéo regardée par les utilisateurs.

2 octobre 2012

Cette mise à jour inclut les changements suivants :

  • 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 la APIs console.

  • La nouvelle section Getting Started (Premiers pas) décrit les conditions préalables et les étapes de base pour créer une application qui utilise l'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 l'utilisation des quotas d'API. Le serveur d'API calcule un coût de requête pour chaque requête, et ce coût est déduit de votre quota d'utilisation de l'API. Étant donné que les coûts des requêtes peuvent varier considérablement d'un type de rapport à l'autre, vous devez planifier l'utilisation efficace de votre quota. Votre application ne doit demander que les métriques et les données dont elle a réellement besoin.

  • La section Dimensions temporelles a été mise à jour pour expliquer que ces dimensions indiquent qu'un rapport Analytics doit 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 seront agrégées de sorte que chaque ligne contienne les données d'une période de sept jours.
    • 30DayTotals : les données du rapport seront agrégées de sorte que chaque ligne contienne les données d'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 Dimensions des entités de reporting a été mise à jour pour indiquer que les requêtes API permettant de récupérer les rapports des propriétaires de contenu doivent filtrer les données à l'aide de l'une de ces dimensions (video, channel 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 populaires. Ces rapports, disponibles en tant que rapports sur les chaînes ou rapports sur les propriétaires de contenu, contiennent des métriques (vues, commentaires, J'aime, etc.) par pays et par vidéo. Vous pouvez désormais trier ces rapports en fonction du nombre d'utilisateurs qui se sont abonnés à une chaîne ou qui s'en sont désabonnés 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 sur la page de lecture d'une vidéo, sur la page de la chaîne et dans le guide qui s'affiche sur la page d'accueil YouTube. Lorsque ces métriques apparaissent dans un rapport spécifique à une vidéo, elles n'incluent que les statistiques de la page de lecture de la vidéo en question.