Exemples de requêtes API

Signalements de vidéos

Métriques sur la durée de visionnage quotidienne pour les vidéos d'une chaîne

Cette requête récupère le nombre de vues quotidiennes, les métriques sur la durée de visionnage et le nombre de nouveaux abonnés pour les vidéos d'une chaîne. Le rapport renvoie une ligne de données pour chaque jour de la période demandée. Les lignes sont triées par ordre chronologique.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Métriques quotidiennes sur les annotations pour les vidéos d'une chaîne

Cette requête récupère le nombre de vues quotidiennes, les taux de clics sur les annotations, les taux de fermeture des annotations et les impressions des annotations pour le contenu de la chaîne. Les résultats sont triés par ordre chronologique.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Rapports sur les playlists

Nombre de vues quotidiennes des playlists d'une chaîne

Cette requête récupère le nombre de vues quotidien (une métrique vidéo agrégée), le nombre de vues de la playlist (une métrique dans la playlist), les lancements de playlists, l'estimation du nombre de minutes regardées et le nombre de vues par playlist pour la chaîne de l'utilisateur authentifié. Les résultats sont triés par ordre chronologique.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

Signalements de vidéos

Métriques sur la durée de visionnage par pays pour les vidéos d'une chaîne

Cette requête permet d'obtenir le nombre de vues, des métriques sur la durée de visionnage et le nombre d'abonnements pour les vidéos d'une chaîne par pays. Le rapport renvoie une ligne de données pour chaque pays dans lequel les vidéos de la chaîne ont été regardées. Les lignes sont triées par ordre décroissant du nombre de minutes regardées.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Métriques d'annotation spécifiques à chaque pays pour les vidéos d'une chaîne

Cette requête permet de connaître le nombre de vues, les taux de clics et de fermeture des annotations et les impressions d'annotations par pays pour les vidéos de la chaîne. Les résultats sont triés par ordre décroissant du taux de clics sur les annotations, ce qui signifie que le pays ayant le taux de clics sur les annotations le plus élevé est listé en premier.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Métriques spécifiques à une province pour les États américains et Washington D.C.

Cette requête récupère le nombre de vues, le nombre estimé de minutes regardées et la durée moyenne de visionnage par province pour les vidéos de la chaîne. Les données couvrent les États américains et Washington (district de Columbia). Les résultats sont triés par ordre alphabétique en fonction des codes ISO 3166-2 des provinces.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 : vidéos les plus vues dans un pays spécifique

Cette requête récupère les 10 vidéos les plus vues de la chaîne, en fonction du nombre de vues au cours de la période spécifiée, dans un pays donné. Les résultats sont triés par nombre de vues, dans l'ordre décroissant.

Remarque : Pour ce rapport, vous devez spécifier une valeur pour le paramètre de requête sort et définir le paramètre maxResults sur une valeur entière de 10 ou moins.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Top 10 des villes américaines par nombre total de vues

Cette requête renvoie la liste des 10 villes américaines qui ont enregistré le plus de vues sur le contenu de la chaîne au cours de la période spécifiée. Vous pouvez modifier la requête pour demander des données pour un autre pays en choisissant une autre valeur valide pour ce filtre. De même, la requête peut être modifiée pour récupérer des données sur un sous-continent, comme l'Europe occidentale ou l'Asie du Sud-Est, à l'aide du filtre sous-continent et de l'une de ses valeurs valides. D'autres filtres sont également acceptés. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 des villes américaines par nombre total de vues pour chaque type de contenu

Cette requête permet d'obtenir la liste des 10 villes américaines qui ont comptabilisé le plus de vues du contenu de la chaîne au cours de la période spécifiée, pour chaque élément creatorContentType accepté. Les résultats sont triés par nombre de vues, dans l'ordre décroissant.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 des villes américaines par durée totale de visionnage

Cette requête récupère la liste des 10 meilleurs jours de la période spécifiée au cours desquels une ville des États-Unis a enregistré la durée de visionnage quotidienne totale la plus élevée pour les contenus de la chaîne. Les résultats de la requête indiquent la durée totale de visionnage, la date à laquelle la durée de visionnage a eu lieu et la ville où le contenu a été estimé comme ayant été visionné. Les résultats sont triés par ordre décroissant de la durée de visionnage totale.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 : vidéos les plus regardées en Europe

Cette requête récupère les 10 vidéos les plus vues de la chaîne en Europe, mesurées en fonction du nombre de vues au cours de la période spécifiée. Vous pouvez modifier la requête pour demander des données sur un autre continent en choisissant une autre valeur valide pour ce filtre. De même, la requête peut être modifiée pour récupérer des données sur un sous-continent, comme l'Europe occidentale ou l'Asie du Sud-Est, à l'aide du filtre sous-continent et de l'une de ses valeurs valides. Les résultats sont triés par nombre de vues dans l'ordre décroissant.

Remarque:Dans ce rapport, vous devez spécifier une valeur pour le paramètre de requête sort et définir le paramètre maxResults sur une valeur entière inférieure ou égale à 10.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Rapports sur les playlists

Métriques de durée de visionnage par pays pour les playlists d'une chaîne

Cette requête récupère le nombre de vues par pays (métrique vidéo agrégée), le nombre de vues de playlist (métrique dans la playlist) et les métriques sur la durée de visionnage des playlists d'une chaîne. Le rapport affiche une ligne de données pour chaque pays dans lequel les playlists de la chaîne ont été regardées. Les lignes sont triées par ordre décroissant du nombre de minutes regardées.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Top 10 : playlists les plus lancées aux États-Unis

Cette requête extrait les 10 playlists que les spectateurs aux États-Unis ont commencé à regarder le plus fréquemment au cours de la période spécifiée. Les résultats sont triés par nombre de lancements de playlist dans l'ordre décroissant.

Remarque : Étant donné que ce rapport utilise la dimension playlist, vous devez spécifier une valeur pour le paramètre de requête sort et définir le paramètre maxResults sur une valeur entière de 10 ou moins.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

Signalements de vidéos

Nombre de vues et durée de visionnage depuis différents lieux de lecture

Cette requête récupère le nombre de vues et la durée de visionnage estimée des vidéos d'une chaîne spécifique. Les résultats sont regroupés en fonction du type de page ou d'application sur laquelle les vidéos ont été lues. Ils sont triés par ordre décroissant du nombre de vues.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Nombre de vues et durée de visionnage quotidiens depuis différents lieux de visionnage

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée aux États-Unis pour les vidéos d'une chaîne spécifique. Les résultats sont regroupés par jour pour chaque type de page ou d'application sur laquelle les vidéos ont été lues. Les résultats sont triés par ordre chronologique.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Top 10 : sites tiers générant le plus de vues pour une vidéo intégrée

Cette requête récupère le nombre de vues et la durée de visionnage estimée d'une vidéo ou d'un groupe de vidéos spécifiques. Les résultats sont regroupés par site tiers sur lequel la vidéo a été intégrée. Les résultats sont triés par ordre décroissant en fonction du nombre de vues. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste d'un ou plusieurs ID vidéo de vos vidéos importées, séparés par une virgule.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Rapports sur les playlists

Nombre de vues des playlists et durée de visionnage selon les emplacements de lecture

Cette requête récupère le nombre de vues (une métrique vidéo agrégée), les vues de playlist (une métrique dans la playlist), la durée de visionnage estimée et les lancements de playlist pour les playlists d'une chaîne spécifique. Les résultats sont regroupés en fonction du type de page ou d'application sur laquelle les vidéos ont été lues, et sont triés par ordre décroissant en fonction du nombre de démarrages de playlist.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Nombre de vues de playlists quotidiennes et durée de visionnage selon les emplacements de lecture

Cette requête récupère les lancements quotidiens de playlists, le nombre de vues (métrique vidéo agrégée), le nombre de vues des playlists (métrique dans la playlist) et la durée de visionnage estimée aux États-Unis pour les playlists d'une chaîne spécifique. Les résultats sont regroupés par jour pour chaque type de page ou d'application où des vues de playlist ont été enregistrées. Les résultats sont triés par ordre chronologique.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

Signalements de vidéos

"J'aime" et "Je n'aime pas" par type de contenu

Cette requête récupère le nombre de "J'aime" et "Je n'aime pas" pour chaque type de contenu d'une chaîne.

dimensions=creatorContentType
metrics=likes,dislikes

Signalements de vidéos

Nombre de vues et durée de visionnage provenant de différentes sources de trafic dans un pays

Cette requête récupère le nombre de vues et la durée de visionnage estimée des vidéos de la chaîne dans un pays spécifié. Les métriques sont agrégées par source de trafic, qui décrit la manière dont les utilisateurs ont accédé à la vidéo.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Nombre de vues et durée de visionnage quotidiens provenant de différentes sources de trafic

Cette requête récupère le nombre de vues et la durée de visionnage estimée quotidiennes pour les vidéos de la chaîne. Les métriques sont agrégées quotidiennement par source de trafic et triées par ordre chronologique.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Top 10 : termes de recherche YouTube générant le plus de trafic pour une vidéo

Cette requête extrait les 10 termes de recherche ayant généré le plus de vues à partir des résultats de recherche YouTube pour une ou plusieurs vidéos spécifiques. Les résultats sont triés par nombre de vues, dans l'ordre décroissant. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste de 500 ID vidéo maximum, séparés par une virgule.

Par exemple, vous pouvez exécuter la requête pour une seule vidéo ou remplacer VIDEO_ID pour identifier les termes de recherche qui génèrent le plus de trafic pour cette vidéo. Vous pouvez également répertorier toutes les vidéos d'une playlist spécifique afin d'identifier les termes de recherche qui génèrent le plus de trafic pour chacune des vidéos de cette playlist.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 : sites Web externes générant le plus de trafic pour une vidéo

Cette requête récupère les 10 sites Web externes ayant généré le plus de vues pour une vidéo ou un groupe de vidéos spécifiques. Les résultats sont triés en fonction de la durée de visionnage estimée, dans l'ordre décroissant. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste d'ID vidéo (jusqu'à 500) de vos vidéos importées, séparés par une virgule.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Rapports sur les playlists

Nombre de vues de playlists et durée de visionnage provenant de différentes sources de trafic dans un pays

Cette requête récupère le nombre de vues (une métrique vidéo agrégée), le nombre de vues de la playlist (une métrique dans une playlist), les lancements de la playlist et la durée de visionnage estimée pour les vues de playlists dans le pays spécifié. Les métriques sont agrégées par source de trafic, qui décrit la manière dont les utilisateurs ont accédé à la playlist.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Nombre de vues de playlists quotidiennes et durée de visionnage pour différentes sources de trafic

Cette requête récupère le nombre de vues quotidiennes des playlists d'une chaîne (métrique dans la playlist), le nombre de lancements de playlists et la durée de visionnage estimée. Elle récupère également le nombre total de vues (une métrique vidéo agrégée). Les métriques sont agrégées quotidiennement par source de trafic et triées par ordre chronologique.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Signalements de vidéos

Métriques quotidiennes par type d'appareil pour le système d'exploitation Android

Cette requête récupère le nombre de vues quotidiennes et la durée de visionnage estimée sur les appareils Android pour les vidéos d'une chaîne spécifique. Les résultats sont regroupés par jour pour chaque type d'appareil sur lequel des vidéos ont été lues. Les résultats sont triés par ordre chronologique.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Métriques quotidiennes sur les systèmes d'exploitation pour les appareils mobiles

Cette requête récupère le nombre de vues quotidiennes et la durée de visionnage estimée sur les appareils mobiles pour les vidéos d'une chaîne spécifique. Les résultats sont regroupés par jour pour chaque système d'exploitation sur lequel des vidéos ont été visionnées. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Métriques quotidiennes sur le système d'exploitation et le type d'appareil

Cette requête récupère le nombre de vues quotidiennes et la durée de visionnage estimée d'une chaîne. Les statistiques sont regroupées par système d'exploitation et par type d'appareil. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Rapports sur les playlists

Métriques quotidiennes sur le type d'appareil pour les vues de playlists sur le système d'exploitation Android

Cette requête récupère les visionnages quotidiennes (une métrique vidéo agrégée), les visionnages de playlists (une métrique dans la playlist) et la durée de visionnage estimée sur les appareils Android pour les playlists d'une chaîne spécifique. Les résultats sont regroupés par jour pour chaque type d'appareil sur lequel des vues de playlist ont été enregistrées. Les résultats sont triés par ordre chronologique.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Métriques quotidiennes sur les systèmes d'exploitation pour les vues de playlists sur les appareils mobiles

Cette requête récupère le nombre de vues quotidiennes (une métrique vidéo agrégée), le nombre de vues de playlists (une métrique dans la playlist) et la durée de visionnage estimée sur les appareils mobiles pour les playlists d'une chaîne spécifique. Les résultats sont regroupés par jour pour chaque système d'exploitation sur lequel des vues de playlist ont été enregistrées. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

Signalements de vidéos

Données démographiques des spectateurs en Californie (tranche d'âge et genre)

Ce rapport fournit des statistiques sur la tranche d'âge et le genre des spectateurs en Californie qui ont regardé les vidéos de la chaîne. Les résultats sont triés par genre, puis par tranche d'âge. Cette requête peut être modifiée pour récupérer les mêmes statistiques pour tous les spectateurs dans le monde entier ou dans un pays, un continent, un sous-continent ou un autre État des États-Unis en ajustant la valeur du paramètre filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Rapports sur les playlists

Données démographiques des spectateurs de playlists en Californie (tranches 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 playlists de la chaîne. Les résultats sont triés par genre, puis par tranche d'âge. Cette requête peut être modifiée pour récupérer les mêmes statistiques pour tous les lecteurs du monde entier ou tous ceux d'un pays, d'un continent, d'un sous-continent ou d'un autre État américain en ajustant la valeur du paramètre filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Métriques de partage, agrégées par service sur lequel des vidéos ont été partagées

Cette requête permet de récupérer le nombre de fois où les utilisateurs ont utilisé le bouton Share pour partager les vidéos d'une chaîne. Les résultats sont regroupés par service de partage (Google+, Twitter, etc.) et triés par ordre décroissant du nombre de partages.

dimensions=sharingService
metrics=shares
sort=-shares

Métriques sur la rétention d'audience d'une vidéo

Ce rapport mesure la capacité d'une vidéo à fidéliser son audience. Vous ne pouvez récupérer le rapport que pour une vidéo à la fois. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par l'ID de l'une de vos vidéos importées. Notez que les rapports sur la rétention d'audience ne permettent pas de spécifier plusieurs valeurs pour le filtre video.

Dans cet exemple, le rapport utilise le filtre audienceType pour limiter la réponse afin qu'elle ne contienne que les données sur les vues naturelles, qui sont le résultat d'une action directe de l'utilisateur, comme la recherche d'une vidéo ou le clic sur une suggestion de vidéo. Par conséquent, le rapport n'inclut pas les données sur les vues générées par les annonces TrueView InStream ou TrueView InDisplay. Vous pouvez supprimer le filtre pour récupérer les données de rétention d'audience de la vidéo pour tous les types d'audience.

Notez que les données du filtre audienceType sont disponibles depuis le 25 septembre 2013. L'API ne renverra pas de données pour les requêtes qui utilisent le filtre pour essayer de récupérer des données de dates antérieures. Les requêtes qui n'utilisent pas le filtre fonctionnent pour toute date postérieure au 1er juillet 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Métriques sur les revenus et les performances des annonces de la chaîne

Cette requête récupère les métriques sur les revenus et les performances des annonces d'un canal. Le rapport renvoie une seule ligne de données contenant les totaux pour chaque métrique demandée au cours de la période spécifiée.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Métriques quotidiennes sur les revenus et les performances des annonces

Cette requête récupère les métriques quotidiennes sur les revenus et les performances des annonces d'un canal.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Métriques de revenus et de performances des annonces spécifiques à un pays

Cette requête récupère les métriques sur les revenus et les performances des annonces d'une chaîne par pays. Les résultats sont triés par ordre décroissant du montant des revenus, ce qui signifie que le premier pays listé est celui dans lequel le partenaire a généré les revenus nets les plus élevés.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Top 10 : vidéos générant les revenus les plus élevés

Cette requête récupère les métriques sur les revenus et les performances des annonces pour les 10 vidéos les plus rentables de la chaîne. Les résultats sont triés par montant de revenus par ordre décroissant, ce qui signifie que la première vidéo sera celle qui a généré les revenus estimés les plus élevés.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Métriques de performances des annonces pour différents types d'annonces

Cette requête récupère les métriques de performances des annonces pour le contenu revendiqué par le propriétaire de contenu. Les résultats sont regroupés par type d'annonce, ce qui vous permet de comparer les revenus et les valeurs de CPM entre les différents types d'annonces.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Signalements de vidéos

Métriques quotidiennes sur la durée de visionnage pour les contenus mis en ligne par l'utilisateur

Cette requête récupère les métriques de durée de visionnage quotidienne, ainsi que le nombre de vues, le nombre de lectures monétisées et le nombre d'impressions pour les vidéos mises en ligne par le propriétaire du contenu. Le rapport renvoie une ligne de données pour chaque jour de la période demandée. Les lignes sont triées par ordre chronologique.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Métriques sur les annotations pour le contenu revendiqué

Cette requête récupère le nombre de vues quotidiennes, les taux de clics sur les annotations, les taux de fermeture des annotations et les impressions des annotations pour le contenu revendiqué par le propriétaire du contenu. Les résultats sont triés par ordre chronologique.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Rapports sur les playlists

Nombre de vues quotidiennes de playlists pour un propriétaire de contenu

Cette demande récupère des métriques sur les interactions quotidiennes des utilisateurs avec les vidéos figurant dans les playlists du propriétaire de contenu. Les métriques récupérées dans le rapport sont playlistViews, playlistStarts, playlistEstimatedMinutesWatched et viewsPerPlaylistStart. Toutes ces métriques sont des métriques dans la playlist. Étant donné que toutes les métriques demandées sont des métriques dans la playlist, la requête n'a pas besoin d'inclure également le filtre playlist ou group.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

Signalements de vidéos

Métriques de durée de visionnage spécifiques à un pays pour les contenus mis en ligne par l'utilisateur

Cette requête récupère le nombre de vues, les métriques de durée de visionnage et les revenus publicitaires estimés pour chaque pays. Les métriques concernent les vidéos mises en ligne par le propriétaire du contenu. Le rapport renvoie une ligne de données pour chaque pays où les vidéos ont été regardées. Les lignes sont triées par ordre décroissant du nombre de minutes regardées.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Métriques d'annotation spécifiques à chaque pays pour les contenus importés par l'utilisateur

Cette requête permet de connaître le nombre de vues, les taux de clics et de fermeture des annotations et les impressions d'annotations par pays pour les vidéos mises en ligne par le propriétaire de contenu. Les résultats sont triés par ordre décroissant du taux de clics sur les annotations, ce qui signifie que le pays ayant le taux de clics sur les annotations le plus élevé est listé en premier.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Métriques spécifiques à une province pour les États américains et Washington D.C.

Cette requête permet d'obtenir la répartition par province du nombre de vues, du nombre estimé de minutes regardées et de la durée moyenne de visionnage pour les vidéos revendiquées par le propriétaire de contenu. Les données couvrent les États américains et Washington (district de Columbia). Les résultats sont triés par ordre alphabétique en fonction des codes ISO 3166-2 des provinces.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 des villes des États-Unis par nombre total de vues

Cette requête permet d'obtenir la liste des 10 villes américaines qui ont comptabilisé le plus grand nombre de vues des vidéos revendiquées par le propriétaire de contenu au cours de la période spécifiée. Vous pouvez modifier la requête pour demander des données pour un autre pays en choisissant une autre valeur valide pour ce filtre. De même, la requête peut être modifiée pour récupérer des données sur un sous-continent, comme l'Europe occidentale ou l'Asie du Sud-Est, à l'aide du filtre sous-continent et de l'une de ses valeurs valides. D'autres filtres sont également acceptés. Les résultats sont triés par nombre de vues, dans l'ordre décroissant.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 des villes américaines par nombre total de vues pour chaque type de contenu

Cette requête permet de récupérer la liste des 10 villes américaines qui ont comptabilisé le plus grand nombre de vues du contenu revendiqué par le propriétaire de contenu au cours de la période spécifiée, pour chaque élément creatorContentType accepté. Les résultats sont triés par nombre de vues, dans l'ordre décroissant.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 des villes américaines par durée de visionnage totale

Cette requête permet de récupérer la liste des 10 premiers jours de la période spécifiée, au cours de laquelle une ville des États-Unis a enregistré la durée totale de visionnage quotidienne la plus élevée pour le contenu revendiqué par le propriétaire de contenu. Les résultats de la requête indiquent la durée totale de visionnage, la date à laquelle la durée de visionnage a eu lieu et la ville où le contenu a été estimé comme ayant été visionné. Les résultats sont triés par ordre décroissant de la durée de visionnage totale.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 : Vidéos les plus regardées en Europe

Cette requête récupère les 10 vidéos les plus regardées en Europe parmi celles revendiquées par le propriétaire du contenu, en fonction du nombre de vues enregistrées au cours de la période spécifiée. Vous pouvez modifier la requête pour demander des données sur un autre continent en choisissant une autre valeur valide pour ce filtre. De même, la requête peut être modifiée afin d'extraire les données d'un sous-continent, tel que l'Europe de l'Ouest ou l'Asie du Sud-Est, en utilisant le filtre subContinent et l'une de ses valeurs valides. Les résultats sont triés par nombre de vues, dans l'ordre décroissant.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Rapports sur les playlists

Métriques de durée de visionnage par pays pour les playlists d'un propriétaire de contenu

Cette requête récupère le nombre de visionnages et les métriques de durée de visionnage des playlists par pays pour toutes les playlists des chaînes du propriétaire du contenu. Le rapport renvoie une ligne de données pour chaque pays dans lequel les playlists ont été regardées. Les lignes sont triées par ordre décroissant du nombre de minutes regardées.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 : playlists les plus lancées aux États-Unis

Cette requête récupère les 10 playlists des chaînes du propriétaire de contenu que les spectateurs aux États-Unis ont commencé à regarder le plus fréquemment au cours de la période spécifiée. Les résultats sont triés par nombre de lancements de playlists dans l'ordre décroissant.

Remarque : Étant donné que ce rapport utilise la dimension playlist, vous devez spécifier une valeur pour le paramètre de requête sort et définir le paramètre maxResults sur une valeur entière de 10 ou moins.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Signalements de vidéos

"J'aime" et "Je n'aime pas" par type de contenu

Cette requête récupère le nombre de "J'aime" et de "Je n'aime pas" pour chaque type de contenu sur une chaîne ou un groupe de chaînes spécifiques. Notez que pour exécuter cette requête dans APIs Explorer, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de 500 ID de canaux séparés par une virgule au maximum.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Signalements de vidéos

Le nombre de vues et la durée de visionnage pour différents contextes de lecture

Cette requête récupère le nombre de vues et la durée de visionnage estimée des vidéos mises en ligne sur une chaîne ou un groupe de chaînes spécifiques. Les résultats sont regroupés en fonction du type de page ou d'application sur laquelle les vidéos ont été lues. Ils sont triés par ordre décroissant du nombre de vues. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de jusqu'à 500 ID de chaîne, séparés par une virgule.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Nombre de vues et durée de visionnage quotidiens depuis différents lieux de visionnage

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée aux États-Unis pour les vidéos mises en ligne sur une chaîne ou un groupe de chaînes spécifique. Les résultats sont regroupés par jour pour chaque type de page ou d'application sur laquelle des vidéos ont été lues. Les résultats sont triés dans l'ordre chronologique inverse. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de jusqu'à 500 ID de chaîne, séparés par une virgule.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 : sites tiers générant le plus de vues pour une vidéo intégrée

Cette requête récupère le nombre de vues et la durée de visionnage estimée d'une vidéo ou d'un groupe de vidéos spécifiques. Les résultats sont regroupés par site tiers sur lequel la vidéo a été intégrée. Les résultats sont triés par ordre décroissant en fonction du nombre de vues. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste d'ID vidéo (jusqu'à 500) de vos vidéos importées, séparés par une virgule.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Rapports sur les playlists

Nombre de vues et durée de visionnage des playlists depuis différents lieux de lecture

Cette requête récupère le nombre de vues de la playlist, la durée de visionnage estimée de la playlist et le nombre de lancements de la playlist pour toutes les playlists des chaînes d'un propriétaire de contenu. Les résultats sont regroupés en fonction du type de page ou d'application sur laquelle les vidéos ont été lues, et sont triés par ordre décroissant en fonction du nombre de démarrages de playlist.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Nombre de vues et durée de visionnage des playlists depuis différents lieux de lecture

Cette requête récupère le nombre de lancements quotidiens de playlists, le nombre de vues de playlists et la durée de visionnage estimée des playlists aux États-Unis pour toutes les playlists des chaînes d'un propriétaire de contenu. Les résultats sont renvoyés pour chaque type de page ou d'application où des vues de playlist ont été enregistrées.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

Signalements de vidéos

Nombre de vues et durée de visionnage provenant de différentes sources de trafic

Cette demande permet de récupérer le nombre de vues et la durée de visionnage estimée des vidéos du propriétaire de contenu. Les métriques sont agrégées par source de trafic, qui décrit la manière dont les utilisateurs ont accédé à la vidéo.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Nombre de vues et durée de visionnage quotidiens provenant de différentes sources de trafic

Cette demande permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée quotidienne des vidéos du propriétaire de contenu. Les métriques sont agrégées quotidiennement par source de trafic et triées dans l'ordre chronologique inverse.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Remarque : Les deux exemples de rapports suivants ne sont compatibles qu'avec des sources de trafic spécifiques. Les sources de trafic VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES et NO_LINK_EMBEDDED ne sont pas compatibles.

Top 10 : termes de recherche YouTube générant le plus de trafic pour une vidéo

Cette requête récupère les 10 termes de recherche ayant généré le plus de vues dans les résultats de recherche YouTube pour une vidéo ou un groupe de vidéos spécifiques. Les résultats sont triés par nombre de vues dans l'ordre décroissant. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste d'ID vidéo (jusqu'à 500) de vos vidéos importées, séparés par une virgule.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 : sites Web externes générant le plus de trafic pour une vidéo

Cette requête récupère les 10 sites Web externes ayant généré le plus de vues dans les résultats de recherche Google pour une vidéo ou un groupe de vidéos spécifiques. Les résultats sont triés en fonction de la durée de visionnage estimée, dans l'ordre décroissant. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par une liste d'ID vidéo (jusqu'à 500) de vos vidéos importées, séparés par une virgule.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Rapports sur les playlists

Nombre de vues de playlists et durée de visionnage provenant de différentes sources de trafic dans un pays

Cette requête récupère le nombre de vues, de lancements et d'estimations de la durée de visionnage des playlists dans un pays spécifié. Les métriques sont agrégées par source de trafic, ce qui décrit la manière dont les utilisateurs ont accédé à la playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Nombre de vues de playlists et durée de visionnage provenant de différentes sources de trafic

Cette requête récupère les vues, les lancements et la durée de visionnage estimée des playlists d'une ou de plusieurs chaînes d'un propriétaire de contenu. Les métriques sont agrégées par source de trafic. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de 500 ID de chaîne maximum, séparés par une virgule.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Signalements de vidéos

Métriques quotidiennes par type d'appareil pour les vidéos revendiquées

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée par type d'appareil pour les vidéos revendiquées par un propriétaire de contenu particulier. Les résultats sont regroupés par jour pour chaque type d'appareil sur lequel les lectures de vidéos ont été effectuées. Les résultats sont triés par ordre chronologique.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Statistiques quotidiennes sur les systèmes d'exploitation pour les vidéos revendiquées visionnées sur des appareils mobiles

Cette requête récupère le nombre de vues quotidiennes et la durée de visionnage estimée par système d'exploitation pour les vues de vidéos revendiquées par un propriétaire de contenu spécifié qui ont eu lieu sur des appareils mobiles. Les résultats sont regroupés par jour pour chaque système d'exploitation sur lequel des vidéos ont été lues. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Métriques quotidiennes sur le système d'exploitation et le type d'appareil

Cette requête récupère le nombre de vues quotidiennes et la durée de visionnage estimée pour les vidéos revendiquées par un propriétaire de contenu spécifique. Les statistiques sont regroupées par système d'exploitation et type d'appareil. Les résultats sont triés par ordre chronologique.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Rapports sur les playlists

Métriques sur le type d'appareil pour les vues de playlists sur le système d'exploitation Android

Cette requête récupère le nombre de vues et la durée de visionnage estimée des playlists sur les appareils Android pour les playlists d'une ou de plusieurs chaînes d'un propriétaire de contenu. Les résultats sont renvoyés pour chaque type d'appareil sur lequel les playlists ont été vues. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne CHANNEL_ID dans la valeur du paramètre filters par une liste de jusqu'à 500 ID de chaîne, séparés par une virgule.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Métriques sur le système d'exploitation pour les vues de playlists sur les appareils mobiles

Cette requête récupère le nombre de vues et la durée de visionnage estimée des playlists sur les appareils mobiles pour les playlists de l'une des chaînes d'un propriétaire de contenu. Les résultats sont renvoyés pour chaque système d'exploitation sur lequel des vues de playlist ont été enregistrées.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

Signalements de vidéos

Données démographiques des spectateurs en Californie (tranche d'âge et genre)

Ce rapport fournit des statistiques sur la tranche d'âge et le genre des spectateurs en Californie qui ont regardé le contenu revendiqué par le propriétaire du contenu. Les résultats sont triés par genre, puis par tranche d'âge. Cette requête peut être modifiée pour récupérer les mêmes statistiques pour tous les spectateurs dans le monde entier ou dans un pays, un continent, un sous-continent ou un autre État des États-Unis en ajustant la valeur du paramètre filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Métriques de partage, agrégées par service dans lequel les vidéos ont été partagées

Cette requête permet de récupérer le nombre de fois où les utilisateurs ont utilisé le bouton Share pour partager des vidéos mises en ligne par le propriétaire du contenu. Les résultats sont agrégés par service de partage (Google+, Twitter, etc.) et triés par ordre décroissant du nombre de partages.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

Métriques sur la rétention d'audience pour une vidéo

Ce rapport mesure la capacité d'une vidéo à fidéliser son public. Le rapport ne peut être récupéré que pour une vidéo à la fois. Notez que pour exécuter cette requête dans l'explorateur d'API, vous devez remplacer la chaîne VIDEO_ID dans la valeur du paramètre filters par l'ID de l'une de vos vidéos importées. Notez que les rapports sur la fidélisation de l'audience ne permettent pas de spécifier plusieurs valeurs pour le filtre video.

Dans cet exemple, le rapport utilise le filtre audienceType pour limiter la réponse afin qu'elle ne contienne que les données sur les vues naturelles, qui sont le résultat d'une action directe de l'utilisateur, comme la recherche d'une vidéo ou le clic sur une suggestion de vidéo. Il n'inclut donc pas de données sur les vues provenant d'annonces TrueView InStream ou TrueView InDisplay. Vous pouvez supprimer le filtre pour récupérer les données sur la rétention d'audience d'une vidéo pour tous les types d'audience.

Notez que les données du filtre audienceType sont disponibles depuis le 25 septembre 2013. L'API ne renverra pas de données pour les requêtes qui utilisent le filtre pour essayer de récupérer des données de dates antérieures. Les requêtes qui n'utilisent pas le filtre fonctionnent pour toute date ultérieure au 1er juillet 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Métriques sur les revenus et les performances des annonces pour les contenus revendiqués

Cette demande permet de récupérer des métriques sur les revenus et les performances des annonces pour le contenu revendiqué par le propriétaire de contenu. Le rapport renvoie une seule ligne de données contenant les totaux pour chaque métrique demandée au cours de la période spécifiée.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Métriques quotidiennes sur les revenus et les performances des annonces

Cette requête récupère les métriques de revenus et de performances des annonces quotidiennes pour le contenu revendiqué par le propriétaire de contenu.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Métriques sur les revenus et les performances des annonces par pays

Cette demande permet de récupérer des métriques sur les performances des annonces et les revenus spécifiques à chaque pays pour les contenus revendiqués du propriétaire de contenu. Les résultats sont triés par ordre décroissant en fonction du montant des revenus, ce qui signifie que le premier pays listé est celui dans lequel le partenaire a généré les revenus estimés les plus élevés.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 : vidéos générant les revenus les plus élevés

Cette requête récupère les métriques sur les revenus et les performances des annonces pour les 10 vidéos revendiquées par le propriétaire du contenu et qui ont généré les revenus les plus élevés. Les résultats sont triés par ordre décroissant en fonction du montant des revenus, ce qui signifie que la première vidéo sera celle qui a généré les revenus estimés les plus élevés.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Métriques de performances des annonces pour différents types d'annonces

Cette demande permet de récupérer des métriques sur les performances des annonces pour le contenu revendiqué par le propriétaire de contenu. Les résultats sont regroupés par type d'annonce, ce qui vous permet de comparer les revenus et les valeurs de CPM pour différents types d'annonces.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType