Exemples de requêtes API

Signalements de vidéos

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

Cette requête permet de récupérer 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 affiche une ligne de données pour chaque jour de la période demandée. Les lignes sont triées dans l'ordre chronologique.

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

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

Cette requête permet d'obtenir le nombre de vues quotidiennes, les taux de clics et de fermeture des annotations, ainsi que les impressions d'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

Vues quotidiennes de la playlist d'une chaîne

Cette requête récupère le nombre de vues quotidiennes (une métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist), le nombre de lancements de la playlist, l'estimation du nombre de minutes regardées et le nombre de vues par lancement de 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 des vidéos d'une chaîne par pays

Cette requête permet de récupérer le nombre de vues des vidéos d'une chaîne, les métriques sur la durée de visionnage et le nombre d'abonnements par pays. Le rapport affiche une ligne de données pour chaque pays où 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 au pays pour les vidéos d'une chaîne

Cette demande permet de récupérer le nombre de vues, les taux de clics et de fermeture des annotations, et les impressions d'annotations des vidéos de la chaîne par pays. Les résultats sont triés par taux de clics sur les annotations dans l'ordre décroissant, ce qui signifie que le pays qui enregistre le taux de clics le plus élevé sera listé en premier.

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

Métriques propres aux provinces pour les États américains et Washington D.C.

Cette demande permet d'obtenir la répartition par province du nombre de vues, de l'estimation du nombre de minutes regardées et de la durée moyenne de visionnage des vidéos de la chaîne. Les données couvrent les États américains et Washington D.C. 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 regardées dans un pays spécifique

Cette requête permet de récupérer les 10 vidéos les plus regardées de la chaîne, mesurés par le nombre de vues enregistrées 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: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=country==US
maxResults=10
sort=-views

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

Cette requête permet de récupérer la liste des 10 villes des États-Unis ayant enregistré le plus de vues du contenu de la chaîne pendant la période spécifiée. Vous pouvez modifier la requête afin d'obtenir des données pour un autre pays en choisissant une autre valeur valide pour ce filtre. De même, vous pouvez modifier la requête pour extraire des données d'un sous-continent, comme l'Europe de l'Ouest ou l'Asie du Sud-Est, en utilisant le filtre subContinent et l'une de ses valeurs valides. D'autres filtres sont également pris en charge. 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

10 villes américaines les plus regardées pour chaque type de contenu

Cette requête permet de récupérer la liste des 10 villes américaines ayant enregistré le plus de vues du contenu de la chaîne pendant la période spécifiée, pour chaque 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 de visionnage totale

Cette requête permet de récupérer la liste des 10 jours qui ont enregistré le plus de vues au cours de la période spécifiée. Les résultats de la requête indiquent la durée de visionnage totale, la date à laquelle elle a eu lieu et la ville où le contenu a été estimé avoir été visionné. Les résultats sont triés par ordre décroissant par rapport à 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 permet de récupérer les 10 vidéos les plus regardées de la chaîne en Europe, d'après le nombre de vues enregistrées pendant la période spécifiée. Vous pouvez modifier la requête afin de demander des données pour un autre continent en choisissant une autre valeur valide pour ce filtre. De même, vous pouvez modifier la requête pour extraire des données d'un sous-continent, comme 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.

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 sur la durée de visionnage des playlists d'une chaîne par pays

Cette requête récupère le nombre de vues par pays (une métrique vidéo agrégée), le nombre de vues d'une playlist (métrique dans une playlist) et la durée de visionnage des playlists d'une chaîne. Le rapport affiche une ligne de données pour chaque pays où 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 populaires aux États-Unis

Cette requête permet de récupérer les 10 playlists que les spectateurs situés aux États-Unis ont le plus regardés au cours de la période spécifiée. Les résultats sont triés par nombre de démarrages de la playlist dans l'ordre décroissant.

Remarque:Comme 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 inférieure ou égale à 10.

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

Signalements de vidéos

le nombre de vues et la durée de visionnage pour différents emplacements de lecture ;

Cette requête permet de récupérer le nombre de vues et la durée de visionnage estimée des vidéos d'une chaîne donnée. Les résultats sont regroupés en fonction du type de page ou d'application où les vidéos ont été lues, et les résultats sont triés par ordre décroissant du nombre de vues.

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

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

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée des vidéos d'une chaîne spécifique aux États-Unis. Les résultats sont regroupés par jour pour chaque type de page ou d'application où des 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 qui génèrent le plus de vues pour une vidéo intégrée

Cette requête permet de récupérer le nombre de vues et la durée de visionnage estimée d'une vidéo ou d'un groupe de vidéos spécifique. Les résultats sont regroupés en fonction du 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 des vidéos que vous avez mises en ligne, 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 de la playlist et durée de visionnage depuis différents emplacements de lecture

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

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

Nombre de vues quotidiennes pour les playlists et durée de visionnage depuis différents emplacements de lecture

Cette requête récupère le nombre de lancements quotidiens des playlists, le nombre de vues (une métrique vidéo agrégée), le nombre de vues de la playlist (métrique dans une 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ù la playlist a été vue. 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 permet de récupérer 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

le nombre de vues et la durée de visionnage de différentes sources de trafic dans un pays ;

Cette demande permet d'obtenir le nombre de vues et la durée de visionnage estimée des vidéos de la chaîne dans un pays donné. Les métriques sont agrégées par source de trafic, c'est-à-dire la manière dont les utilisateurs ont accédé à la vidéo.

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

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

Cette demande permet d'obtenir le nombre de vues quotidiennes et la durée estimée de visionnage quotidienne des 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 qui génèrent le plus de trafic pour une vidéo

Cette requête permet de récupérer les 10 termes de recherche ayant généré le plus de vues dans les 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 APIs Explorer, 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 afin d'identifier les termes de recherche qui génèrent le plus de trafic pour cette vidéo. Vous pouvez également lister toutes les vidéos d'une playlist pour 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 qui génèrent le plus de trafic pour une vidéo

Cette requête permet d'extraire les 10 sites Web externes ayant généré le plus de vues pour une vidéo ou un groupe de vidéos spécifique. Les résultats sont triés par durée de visionnage estimée, dans l'ordre décroissant. 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 de 500 ID vidéo maximum 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 la playlist 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), de vues de la playlist (métrique dans une playlist), le nombre de lancements de la playlist et la durée de visionnage estimée pour les vues des playlists dans un pays spécifié. Les métriques sont agrégées par source de trafic, ce qui indique la manière dont les utilisateurs ont accédé à la playlist.

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

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

Cette requête permet de récupérer le nombre de vues quotidiennes de la playlist d'une chaîne (métrique dans une playlist), les lancements de playlist et la durée de visionnage estimée. Il 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 permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée des vidéos d'une chaîne spécifique sur des appareils Android. Les résultats sont regroupés par jour pour chaque type d'appareil sur lequel les 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 du système d'exploitation pour les appareils mobiles

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

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

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

Cette requête permet de récupérer 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 par 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 quotidiennes (métrique agrégée sur les vidéos), le nombre de vues d'une playlist (métrique dans une playlist) et la durée de visionnage estimée des playlists d'une chaîne spécifique sur les appareils Android. Les résultats sont regroupés par jour pour chaque type d'appareil sur lequel les playlists ont été regardé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 du système d'exploitation pour les vues des playlists sur les appareils mobiles

Cette requête récupère le nombre de vues quotidiennes (métrique agrégée sur les vidéos), les vues de playlists (métrique dans une playlist) et la durée de visionnage estimée des playlists d'une chaîne spécifique sur des appareils mobiles. Les résultats sont regroupés par jour pour chaque système d'exploitation sur lequel les vues de la playlist ont eu lieu. 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 récupère des statistiques sur la tranche d'âge et le genre des spectateurs californiens qui ont regardé les vidéos de la chaîne. Les résultats sont triés par genre, puis par tranche d'âge. Vous pouvez modifier cette requête afin d'obtenir les mêmes statistiques pour tous les spectateurs du monde entier ou pour tous les spectateurs d'un pays, continent, sous-continent ou 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 (tranche d'âge et genre)

Ce rapport récupère des statistiques sur la tranche d'âge et le genre des spectateurs californiens qui ont regardé les playlists de la chaîne. Les résultats sont triés par genre, puis par tranche d'âge. Vous pouvez modifier cette requête afin d'obtenir les mêmes statistiques pour tous les spectateurs du monde entier ou pour tous les spectateurs 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

Métriques sur les partages, agrégées par service sur lequel les vidéos ont été partagées

Cette requête permet de récupérer le nombre de fois où les utilisateurs ont partagé les vidéos d'une chaîne à l'aide du bouton Share. 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 pour une vidéo

Ce rapport mesure la capacité d'une vidéo à fidéliser son audience. Le rapport ne peut être récupéré que pour une vidéo à la fois. 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 l'ID vidéo de l'une des vidéos que vous avez mises en ligne. Notez qu'il n'est pas possible de spécifier plusieurs valeurs pour le filtre video dans les rapports sur la rétention d'audience.

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 (résultat d'une action directe de l'utilisateur, comme la recherche d'une vidéo ou un clic sur une suggestion de vidéo). Par conséquent, le rapport n'inclut pas de 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 à des 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 de la chaîne et les performances des annonces

Cette demande permet de récupérer les métriques sur les revenus et les performances des annonces d'une chaîne. Le rapport affiche une seule ligne de données contenant les totaux de chaque métrique demandée pour la période spécifiée.

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

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

Cette demande permet de récupérer les métriques sur les revenus quotidiens et les performances des annonces d'une chaîne.

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

Métriques sur les revenus et les performances des annonces spécifiques à chaque pays

Cette demande permet de récupérer les métriques sur les performances des annonces et les revenus spécifiques à un pays pour une chaîne. Les résultats sont triés par ordre décroissant en fonction du montant des revenus. Cela signifie que le premier pays répertorié sera celui où 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 aux revenus les plus élevés

Cette demande permet de récupérer des métriques sur les revenus et les performances des annonces pour les 10 vidéos de la chaîne ayant 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
maxResults=10
sort=-estimatedRevenue

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

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

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

Signalements de vidéos

Métriques sur la durée de visionnage quotidienne des contenus auto-mis en ligne

Cette requête permet de récupérer les statistiques quotidiennes sur la durée de visionnage, ainsi que le nombre de vues, de lectures monétisées et d'impressions pour les vidéos mises en ligne par le propriétaire de 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 demande permet d'obtenir le nombre de vues quotidiennes, les taux de clics et de fermeture des annotations, ainsi que les impressions d'annotations pour le contenu revendiqué par le propriétaire de 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

de vues quotidiennes pour les playlists d'un propriétaire de contenu

Cette demande récupère les 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 une playlist. Étant donné que toutes les métriques demandées sont des métriques dans des playlists, il n'est pas nécessaire d'inclure le filtre playlist ou groupe.

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

Signalements de vidéos

Métriques sur la durée de visionnage par pays pour les contenus auto-importés

Cette requête récupère le nombre de vues, les métriques sur la durée de visionnage et les revenus publicitaires estimés pour chaque pays. Ces métriques concernent les vidéos mises en ligne par le propriétaire de contenu. Le rapport affiche une ligne de données pour chaque pays dans lequel 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 aux pays pour les contenus auto-importés

Cette demande permet d'obtenir 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 taux de clics sur les annotations dans l'ordre décroissant, ce qui signifie que le pays qui enregistre le taux de clics le plus élevé sera listé en premier.

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

Métriques propres aux provinces pour les États américains et Washington D.C.

Cette demande permet d'obtenir la répartition, région par province, du nombre de vues, de l'estimation du nombre de minutes regardées et de la durée moyenne de visionnage des vidéos revendiquées par le propriétaire du contenu. Les données couvrent les États américains et Washington D.C. 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 américaines par nombre total de vues

Cette requête permet de récupérer la liste des 10 villes des États-Unis ayant enregistré le plus 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 afin d'obtenir des données pour un autre pays en choisissant une autre valeur valide pour ce filtre. De même, vous pouvez modifier la requête pour extraire des données d'un sous-continent, comme l'Europe de l'Ouest ou l'Asie du Sud-Est, en utilisant le filtre subContinent et l'une de ses valeurs valides. D'autres filtres sont également pris en charge. 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

10 villes américaines les plus regardées pour chaque type de contenu

Cette requête permet de récupérer la liste des 10 villes américaines ayant enregistré le plus de vues du contenu revendiqué par le propriétaire de contenu pendant la période spécifiée, pour chaque 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 jours ayant enregistré le plus de vues au cours de la période spécifiée, au cours de laquelle une ville des États-Unis a enregistré la plus grande durée de visionnage quotidienne totale du contenu revendiqué par le propriétaire de contenu. Les résultats de la requête indiquent la durée de visionnage totale, la date à laquelle elle a eu lieu et la ville où le contenu a été estimé avoir été visionné. Les résultats sont triés par ordre décroissant par rapport à 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 permet de récupérer les 10 vidéos les plus regardées en Europe parmi celles revendiquées par le propriétaire de contenu, d'après le nombre de vues enregistrées au cours de la période spécifiée. Vous pouvez modifier la requête afin de demander des données pour un autre continent en choisissant une autre valeur valide pour ce filtre. De même, vous pouvez modifier la requête pour extraire des données d'un sous-continent, comme 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 sur la durée de visionnage par pays pour les playlists d'un propriétaire de contenu

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

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

Top 10 : playlists les plus populaires aux États-Unis

Cette requête récupère les 10 playlists des chaînes du propriétaire de contenu que les spectateurs américains ont commencé à regarder le plus souvent au cours de la période spécifiée. Les résultats sont triés par nombre de démarrages de la 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 également 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 permet de récupérer le nombre de "J'aime" et "Je n'aime pas" pour chaque type de contenu sur une chaîne ou un groupe de chaînes spécifique. 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 maximum séparés par une virgule.

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 emplacements de lecture ;

Cette requête permet de récupérer 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écifique. Les résultats sont regroupés en fonction du type de page ou d'application où les vidéos ont été lues, et les résultats sont triés par ordre décroissant du nombre de vues. 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 maximum séparés par une virgule.

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

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

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 où 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 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 maximum séparés par une virgule.

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

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

Cette requête permet de récupérer le nombre de vues et la durée de visionnage estimée d'une vidéo ou d'un groupe de vidéos spécifique. Les résultats sont regroupés en fonction du 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 de 500 ID vidéo maximum 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 de la playlist et durée de visionnage depuis différents emplacements de lecture

Cette requête permet de récupérer le nombre de vues, la durée de visionnage estimée et le nombre de lancements de playlists pour toutes les playlists des chaînes d'un propriétaire de contenu. Les résultats sont agrégés en fonction du type de page ou d'application où les vidéos ont été lues. Ils sont triés par ordre décroissant en fonction du lancement de la playlist.

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

Nombre de vues de la playlist et durée de visionnage depuis différents emplacements de lecture

Cette requête récupère les lancements quotidiens de playlists, le nombre de vues et la durée de visionnage estimée 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ù les playlists ont été vues.

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 d'obtenir 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, c'est-à-dire la manière dont les utilisateurs ont accédé à la vidéo.

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

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

Cette demande permet d'obtenir le nombre de vues quotidiennes et la durée de visionnage estimée par jour pour les 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. Par exemple, la source de trafic "NO_LINK_EMBEDDED" ne comporte pas d'informations supplémentaires. Par conséquent, ces rapports ne sont pas disponibles pour cette source. Consultez la définition insightTrafficSourceType pour en savoir plus sur les sources de trafic pour lesquelles ces types de rapports sont disponibles.

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

Cette requête permet de récupérer 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écifique. Les résultats sont triés par nombre de vues, dans l'ordre décroissant. 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 de 500 ID vidéo maximum 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 qui génèrent le plus de trafic pour une vidéo

Cette requête permet de récupérer les 10 sites Web externes ayant généré le plus de vues à partir des résultats de recherche Google pour une vidéo ou un groupe de vidéos spécifique. Les résultats sont triés par durée de visionnage estimée, dans l'ordre décroissant. 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 de 500 ID vidéo maximum 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 la playlist 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 la playlist, le nombre de lancements de la playlist et sa durée de visionnage estimée pour les vues de 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 la playlist et durée de visionnage provenant de différentes sources de trafic

Cette demande permet de récupérer 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 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 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 spécifique. Les résultats sont regroupés par jour pour chaque type d'appareil sur lequel les vidéos ont été lues. Les résultats sont triés par ordre chronologique.

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

Métriques quotidiennes du système d'exploitation pour les vidéos revendiquées visionnées sur des appareils mobiles

Cette requête permet de récupérer 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écifique sur un appareil mobile. Les résultats sont regroupés par jour pour chaque système d'exploitation sur lequel les 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 du système d'exploitation et du type d'appareil

Cette requête permet de récupérer le nombre de vues quotidiennes et la durée de visionnage estimée des vidéos revendiquées par un propriétaire de contenu spécifique. 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 par 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 des playlists et leur durée de visionnage estimée 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 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 maximum séparés par une virgule.

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

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

Cette requête permet de récupérer le nombre de vues et la durée de visionnage estimée des playlists sur des appareils mobiles pour les playlists de n'importe quelle chaîne d'un propriétaire de contenu. Les résultats sont renvoyés pour chaque système d'exploitation sur lequel les affichages de playlists ont eu lieu.

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 récupère des statistiques sur la tranche d'âge et le genre des spectateurs californiens qui ont regardé le contenu revendiqué par le propriétaire. Les résultats sont triés par genre, puis par tranche d'âge. Vous pouvez modifier cette requête afin d'obtenir les mêmes statistiques pour tous les spectateurs du monde entier ou pour tous les spectateurs d'un pays, continent, sous-continent ou 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 sur les partages, agrégées par service sur lequel les vidéos ont été partagées

Cette demande permet de récupérer le nombre de fois où les utilisateurs ont partagé des vidéos mises en ligne par le propriétaire de contenu à l'aide du bouton Share. 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
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 audience. Le rapport ne peut être récupéré que pour une vidéo à la fois. 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 l'ID vidéo de l'une des vidéos que vous avez mises en ligne. Notez qu'il n'est pas possible de spécifier plusieurs valeurs pour le filtre video dans les rapports sur la rétention d'audience.

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 (résultat d'une action directe de l'utilisateur, comme la recherche d'une vidéo ou un clic sur une suggestion de vidéo). Par conséquent, le rapport n'inclut pas de 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 à des 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 le contenu revendiqué

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

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

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

Cette demande récupère les métriques sur les revenus quotidiens et les performances des annonces pour les contenus revendiqués 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 spécifiques à chaque pays

Cette demande récupère des métriques sur les revenus et les performances des annonces spécifiques à chaque pays pour les contenus revendiqués par le propriétaire de contenu. Les résultats sont triés par ordre décroissant en fonction du montant des revenus. Cela signifie que le premier pays répertorié sera celui où 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 aux revenus les plus élevés

Cette demande 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 de 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 sur les performances des annonces pour différents types d'annonces

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

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