Exemplo de solicitações de API

Relatórios de vídeo

Métricas diárias de tempo de exibição para vídeos de um canal

Essa consulta recupera as contagens de visualizações diárias, as métricas de tempo de exibição e as contagens de novos inscritos dos vídeos de um canal. O relatório retorna uma linha de dados por dia no período solicitado. As linhas são classificadas em ordem cronológica.

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

Métricas de anotação diárias para vídeos de um canal

Esta solicitação recupera contagens diárias de visualização, taxas de clique de anotação, taxas de fechamento de anotação e impressões de anotação para o conteúdo do canal. Os resultados são classificados em ordem cronológica.

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

Relatórios de playlists

Visualizações diárias de playlists de um canal

Essa solicitação recupera as contagens de visualizações diárias (uma métrica de vídeo agregada), as visualizações de playlist (uma métrica na playlist), as inicializações de playlist, os minutos assistidos estimados e as visualizações por inicialização de playlist do canal do usuário autenticado. Os resultados são classificados em ordem cronológica.

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

Relatórios de vídeo

Métricas de tempo de exibição específicas de um país para vídeos de um canal

Essa consulta recupera as contagens de visualizações, as métricas de tempo de exibição e os números de inscrições específicos de cada país para os vídeos de um canal. O relatório retorna uma linha de dados para cada país em que os vídeos do canal foram assistidos. As linhas são classificadas em ordem decrescente do número de minutos assistidos.

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

Métricas de anotação específicas de um país para vídeos de um canal

Esta solicitação recupera contagens de visualização específicas de um país, taxas de clique de anotação, taxas de fechamento de anotação e impressões de anotação para os vídeos do canal. Os resultados são classificados por taxa de clique de anotação em ordem decrescente, o que significa que o país com a maior taxa de clique de anotação será o primeiro da lista.

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

Métricas específicas de províncias para os estados dos EUA e Washington, D.C.

Essa solicitação recupera um detalhamento por província das contagens de visualizações, minutos assistidos estimados e duração média das visualizações dos vídeos do canal. Os dados abrangem os estados dos EUA e Washington D.C. Os resultados são classificados em ordem alfabética pelos códigos ISO 3166-2 das províncias.

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

10 mais – Vídeos mais visualizados em um país específico

Esta consulta recupera os 10 vídeos mais visualizados do canal, conforme medido pelo número de visualizações durante o período especificado em determinado país. Os resultados são classificados por contagem de visualizações em ordem decrescente.

Observação: para gerar esse relatório, é necessário especificar um valor para o parâmetro de solicitação sort e definir o parâmetro maxResults como um valor inteiro de 10 ou menos.

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

As 10 principais cidades dos EUA por visualizações totais

Essa consulta recupera uma lista das 10 cidades dos EUA que tiveram mais visualizações do conteúdo do canal durante o período especificado. A consulta pode ser modificada para solicitar dados de outro país escolhendo outro valor válido para esse filtro. Da mesma forma, a consulta pode ser modificada para recuperar dados de um subcontinente, como a Europa Ocidental ou o Sudeste Asiático, usando o filtro subContinent e um dos valores válidos. Outros filtros também são compatíveis. Os resultados são classificados por contagem de visualizações em ordem decrescente.

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

As 10 principais cidades dos EUA por visualizações totais para cada tipo de conteúdo

Essa consulta recupera uma lista das 10 cidades dos EUA que tiveram mais visualizações do conteúdo do canal durante o período especificado para cada creatorContentType compatível. Os resultados são classificados por contagem de visualizações em ordem decrescente.

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

10 principais cidades dos EUA por tempo de exibição total

Essa consulta recupera uma lista dos 10 dias mais importantes durante o período especificado em que qualquer cidade dos EUA teve o maior tempo de exibição diário do conteúdo do canal. Os resultados da consulta identificam o tempo de exibição total, a data em que ele ocorreu e a cidade em que o conteúdo foi visualizado. Os resultados são classificados em ordem decrescente do tempo total de exibição.

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

Top 10: vídeos mais assistidos na Europa

Essa consulta recupera os 10 vídeos mais assistidos do canal na Europa, medidos pelo número de visualizações durante o período especificado. A consulta pode ser modificada para solicitar dados de outro continente escolhendo outro valor válido para esse filtro. Da mesma forma, a consulta pode ser modificada para recuperar dados de um subcontinente, como a Europa Ocidental ou o Sudeste Asiático, usando o filtro subContinent e um dos valores válidos. Os resultados são classificados por contagem de visualizações em ordem decrescente.

Observação: para gerar esse relatório, é necessário especificar um valor para o parâmetro de solicitação sort e definir o parâmetro maxResults como um valor inteiro de 10 ou menos.

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

Relatórios de playlists

Métricas de tempo de exibição específicas de um país para as playlists de um canal

Essa consulta recupera as contagens de visualizações específicas de cada país (uma métrica de vídeo agregada), as visualizações de playlist (uma métrica na playlist) e as métricas de tempo de exibição das playlists de um canal. O relatório retorna uma linha de dados para cada país em que as playlists do canal foram assistidas. As linhas são classificadas em ordem decrescente do número de minutos assistidos.

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

Top 10: playlists mais iniciadas nos Estados Unidos

Essa consulta recupera as 10 playlists que os espectadores nos Estados Unidos começaram a assistir com mais frequência durante o período especificado. Os resultados são classificados pelo número de inícios de playlist em ordem decrescente.

Observação: como este relatório usa a dimensão playlist, é necessário especificar um valor para o parâmetro de solicitação sort e definir o parâmetro maxResults como um valor inteiro de 10 ou menos.

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

Relatórios de vídeo

Contagens de exibições e tempo de exibição de diferentes locais de reprodução

Esta consulta recupera o número de visualizações e o tempo de exibição estimado para vídeos de determinado canal. Os resultados são agregados com base no tipo de página ou aplicativo em que as exibições de vídeo ocorreram e são classificados em ordem decrescente pela contagem de visualizações.

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

Contagens de visualizações diárias e tempo de exibição de diferentes locais de reprodução

Essa consulta recupera as contagens de visualizações diárias e o tempo de exibição estimado nos Estados Unidos para os vídeos de um canal específico. Os resultados são agrupados por dia para cada tipo de aplicativo ou página em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.

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

10 mais – Sites de terceiros que geram o maior número de visualizações para um vídeo incorporado

Essa consulta recupera as contagens de visualizações e o tempo de exibição estimado de um vídeo ou grupo de vídeos específico. Os resultados são agrupados por site de terceiros em que o vídeo foi incorporado. Os resultados são classificados em ordem decrescente pela contagem de visualizações. Para executar essa consulta no API Explorer, substitua a string VIDEO_ID no valor do parâmetro filters por uma lista separada por vírgulas de um ou mais IDs de vídeos enviados.

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

Relatórios de playlists

Contagem de visualizações de playlists e tempo de exibição de diferentes locais de reprodução

Essa consulta recupera o número de visualizações (uma métrica de vídeo agregada), visualizações de playlists (uma métrica em uma playlist), tempo de exibição estimado e inicializações de playlists para playlists de um determinado canal. Os resultados são agregados com base no tipo de página ou aplicativo em que as reproduções de vídeo ocorreram e são classificados em ordem decrescente por inícios de playlist.

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

Contagem de visualizações diárias de playlists e tempo de exibição de diferentes locais de reprodução

Essa consulta recupera as execuções diárias de playlists, as contagens de visualizações (uma métrica de vídeo agregada), as visualizações de playlist (uma métrica na playlist) e o tempo de exibição estimado nos Estados Unidos para as playlists de um canal específico. Os resultados são agrupados por dia para cada tipo de página ou aplicativo em que as visualizações de playlist ocorreram. Os resultados são classificados em ordem cronológica.

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

Relatórios de vídeo

Marcações "Gostei" e "Não gostei" por tipo de conteúdo

Essa consulta recupera o número de marcações "Gostei" e "Não gostei" para cada tipo de conteúdo em um canal.

dimensions=creatorContentType
metrics=likes,dislikes

Relatórios de vídeo

Contagens de exibições e tempo de exibição de diferentes origens de tráfego em um país

Esta solicitação recupera o número de visualizações e o tempo de exibição estimado para os vídeos do canal em um país especificado. As métricas são agregadas por origem de tráfego, que descreve a maneira pela qual os usuários chegaram ao vídeo.

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

Contagens de visualizações diárias e tempo de exibição de diferentes origens de tráfego

Essa solicitação recupera as contagens de visualizações diárias e o tempo de exibição estimado diário dos vídeos do canal. As métricas são agregadas diariamente por origem de tráfego e classificadas em ordem cronológica.

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

10 mais – Termos de pesquisa do YouTube que geram mais tráfego para um vídeo

Essa consulta recupera os 10 termos de pesquisa que geraram mais visualizações nos resultados da pesquisa do YouTube para um ou mais vídeos específicos. Os resultados são classificados por contagem de visualizações em ordem decrescente. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID no valor do parâmetro filters por uma lista separada por vírgulas de até 500 IDs de vídeo.

Por exemplo, você pode executar a consulta para um único vídeo ou substituir VIDEO_ID para identificar os termos de pesquisa que geram mais tráfego para esse vídeo. Você também pode listar todos os vídeos em uma lista de reprodução específica para determinar quais termos de pesquisa geram mais tráfego para qualquer um dos vídeos dessa lista de reprodução.

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

Top 10: sites externos que geram mais tráfego para um vídeo

Essa consulta recupera os 10 sites externos que geraram mais visualizações para um vídeo ou grupo de vídeos específico. Os resultados são classificados por tempo de exibição estimado em ordem decrescente. Para executar essa consulta no APIs Explorer, você precisa substituir a string VIDEO_ID no valor de parâmetro filters por uma lista separada por vírgulas de até 500 IDs dos vídeos enviados.

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

Relatórios de playlists

as contagens de visualizações da playlist e o tempo de exibição de diferentes origens de tráfego em um país;

Essa solicitação recupera o número de visualizações (uma métrica de vídeo agregada), visualizações de playlists (uma métrica na playlist), inicializações de playlists e o tempo de exibição estimado para visualizações de playlists em um país especificado. As métricas são agregadas por origem do tráfego, que descreve como os usuários acessaram a playlist.

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

Contagens de visualizações diárias de playlists e tempo de exibição de diferentes origens de tráfego

Essa solicitação recupera as visualizações diárias de playlist de um canal (uma métrica na playlist), as inicializações de playlist e o tempo de exibição estimado. Ele também recupera o total de visualizações (uma métrica de vídeo agregada). As métricas são agregadas diariamente por origem de tráfego e classificadas em ordem cronológica.

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

Relatórios de vídeo

Métricas diárias do tipo de dispositivo para o sistema operacional Android

Essa consulta recupera as contagens de visualizações diárias e o tempo de exibição estimado em dispositivos Android para os vídeos de um canal específico. Os resultados são agrupados por dia para cada tipo de dispositivo em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.

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

Métricas diárias do sistema operacional para dispositivos móveis

Essa consulta recupera as contagens de visualizações diárias e o tempo de exibição estimado em dispositivos móveis para os vídeos de um canal específico. Os resultados são agrupados por dia para cada sistema operacional em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.

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

Métricas diárias do sistema operacional e do tipo de dispositivo

Essa consulta recupera as contagens de visualizações diárias e o tempo de exibição estimado de um canal. As estatísticas são agrupadas por sistema operacional e tipo de dispositivo. Os resultados são classificados em ordem cronológica.

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

Relatórios de playlists

Métricas diárias de tipo de dispositivo para visualizações de playlist no sistema operacional Android

Essa consulta recupera as visualizações diárias (uma métrica de vídeo agregada), as visualizações de playlist (uma métrica na playlist) e o tempo de exibição estimado em dispositivos Android para as playlists de um canal específico. Os resultados são agrupados por dia para cada tipo de dispositivo em que as visualizações de playlist ocorreram. Os resultados são classificados em ordem cronológica.

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

Métricas diárias do sistema operacional para visualizações de playlist em dispositivos móveis

Essa consulta recupera as visualizações diárias (uma métrica de vídeo agregada), as visualizações de playlist (uma métrica na playlist) e o tempo de exibição estimado em dispositivos móveis para as playlists de um canal específico. Os resultados são agrupados por dia para cada sistema operacional em que as visualizações da playlist ocorreram. Os resultados são classificados em ordem cronológica.

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

Relatórios de vídeo

Informações demográficas dos espectadores na Califórnia (idade e gênero)

Neste relatório, são exibidas as estatísticas sobre a faixa etária e o gênero dos espectadores da Califórnia que assistiram aos vídeos do canal. Os resultados são classificados por gênero e depois por faixa etária. Essa consulta pode ser modificada para recuperar as mesmas estatísticas de todos os espectadores do mundo todo ou de todos os espectadores de um país, continente, subcontinente ou outro estado dos EUA ajustando o valor do parâmetro filters.

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

Relatórios de playlists

Informações demográficas dos espectadores da playlist na Califórnia (idade e gênero)

Esse relatório extrai estatísticas sobre a faixa etária e o gênero dos espectadores na Califórnia que assistiram as playlists do canal. Os resultados são classificados por gênero e depois por faixa etária. Essa consulta pode ser modificada para recuperar as mesmas estatísticas para todos os espectadores do mundo ou para todos os espectadores em um país, continente, subcontinente ou outro estado dos EUA, ajustando o valor do parâmetro filters.

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

Métricas de compartilhamento, agregadas por serviço onde os vídeos foram compartilhados

Essa solicitação recupera o número de vezes que os usuários usaram o botão Share para compartilhar os vídeos de um canal. Os resultados são agregados por serviço de compartilhamento (Google+, Twitter etc) e classificados em ordem decrescente do número de compartilhamentos.

dimensions=sharingService
metrics=shares
sort=-shares

Métricas de retenção de público de um vídeo

Esse relatório mede a capacidade de um vídeo de manter o público assistindo. Só é possível recuperar o relatório de um vídeo por vez. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID no valor do parâmetro filters pelo ID de um dos vídeos enviados. Os relatórios de retenção de público-alvo não permitem especificar vários valores para o filtro video.

Neste exemplo, o relatório usa o filtro audienceType para restringir a resposta para que ela contenha apenas dados de visualizações orgânicas, que são o resultado de uma ação direta do usuário, como uma pesquisa de um vídeo ou um clique em um vídeo sugerido. Por isso, o relatório não inclui dados de visualizações de anúncios TrueView in-stream ou TrueView em display. Você pode remover o filtro para recuperar os dados de retenção de público do vídeo de todos os tipos de público.

Os dados do filtro audienceType estão disponíveis desde 25 de setembro de 2013. A API não vai retornar dados para consultas que usam o filtro para tentar recuperar dados de datas anteriores. As consultas que não usam o filtro funcionam para qualquer data após 1º de julho de 2008.

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

Métricas de receita do canal e de performance do anúncio

Essa solicitação recupera as métricas de performance do anúncio e da receita de um canal. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.

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

Métricas de receita diária e performance do anúncio

Essa solicitação recupera as métricas de performance e receita diária de um canal.

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

Métricas de receita e performance de anúncios específicas por país

Essa solicitação recupera as métricas de performance do anúncio e da receita específica de cada país de um canal. Os resultados são classificados em ordem decrescente pelo valor da receita, o que significa que o primeiro país listado é aquele em que o parceiro teve a maior receita líquida.

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

Top 10: vídeos com a maior receita

Essa solicitação recupera as métricas de receita e performance do anúncio dos 10 vídeos do canal com maior receita. Os resultados são classificados em ordem decrescente pelo valor da receita, o que significa que o primeiro vídeo será aquele que teve a maior receita estimada.

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

Métricas de desempenho de anúncios para diferentes tipos de anúncios

Esta solicitação recupera métricas de desempenho de anúncios para o conteúdo reivindicado do proprietário do conteúdo. Os resultados são agrupados por tipo de anúncio, o que permite comparar os valores de receita e CPM entre diferentes tipos de anúncio.

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

Relatórios de vídeo

Métricas diárias do tempo de exibição para o conteúdo enviado automaticamente

Esta consulta recupera métricas diárias de tempo de exibição, bem como contagens de visualização, de reprodução monetizada e contagens de impressões para vídeos que o proprietário do conteúdo enviou. O relatório retorna uma linha de dados para cada dia no período solicitado. As linhas são classificadas em ordem cronológica.

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

Métricas de anotação para o conteúdo reivindicado

Essa solicitação recupera as contagens de visualizações diárias, as taxas de cliques e de fechamento de anotações e as impressões de anotações do conteúdo reivindicado pelo proprietário. Os resultados são classificados em ordem cronológica.

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

Relatórios de playlists

Visualizações diárias de playlists de um proprietário de conteúdo

Essa solicitação recupera as métricas das interações diárias dos usuários com vídeos nas playlists do proprietário do conteúdo. As métricas recuperadas no relatório são playlistViews, playlistStarts, playlistEstimatedMinutesWatched e viewsPerPlaylistStart. Todas essas métricas são métricas na playlist. Como todas as métricas solicitadas são de playlist, a solicitação não precisa incluir o filtro playlist ou grupo.

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

Relatórios de vídeo

Métricas do tempo de exibição específico de um país para o conteúdo enviado automaticamente

Essa consulta recupera contagens de visualizações, métricas de tempo de exibição e receita estimada de anúncios para cada país. As métricas são para vídeos que o proprietário do conteúdo enviou. O relatório retorna uma linha de dados para cada país em que os vídeos foram assistidos. As linhas são classificadas em ordem decrescente do número de minutos assistidos.

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

Métricas de anotação específicas de um país para o conteúdo enviado automaticamente

Essa solicitação recupera as contagens de visualizações, as taxas de cliques e de fechamento de anotações e as impressões de anotações específicas do país para os vídeos enviados pelo proprietário do conteúdo. Os resultados são classificados por taxa de clique de anotação em ordem decrescente, o que significa que o país com a maior taxa de clique de anotação será o primeiro da lista.

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

Métricas específicas de províncias para os estados dos EUA e Washington, D.C.

Essa solicitação recupera um detalhamento por província das contagens de visualizações, dos minutos assistidos estimados e da duração média das visualizações dos vídeos reivindicados pelo proprietário do conteúdo. Os dados abrangem os estados dos EUA e Washington, D.C. Os resultados são classificados em ordem alfabética pelos códigos ISO 3166-2 das províncias.

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

As 10 principais cidades dos EUA por visualizações totais

Essa consulta recupera uma lista das 10 cidades dos EUA com mais visualizações dos vídeos reivindicados pelo proprietário do conteúdo durante o período especificado. A consulta pode ser modificada para solicitar dados de outro país. Para isso, escolha outro valor válido para esse filtro. Da mesma forma, a consulta pode ser modificada para recuperar dados de um subcontinente, como a Europa Ocidental ou o Sudeste Asiático, usando o filtro subContinent e um dos valores válidos. Outros filtros também são compatíveis. Os resultados são classificados por contagem de visualizações em ordem decrescente.

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

As 10 principais cidades dos EUA por visualizações totais para cada tipo de conteúdo

Essa consulta recupera uma lista das 10 cidades dos EUA que tiveram mais visualizações do conteúdo reivindicado pelo proprietário durante o período especificado para cada creatorContentType compatível. Os resultados são classificados por contagem de visualizações em ordem decrescente.

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

10 principais cidades dos EUA por tempo de exibição total

Esta consulta recupera uma lista dos dez dias principais durante o período especificado quando qualquer cidade dos EUA foi responsável pelo maior tempo de exibição diário total do conteúdo reivindicado pelo proprietário do conteúdo. Os resultados da consulta identificam o tempo total de exibição, a data em que o tempo de exibição ocorreu e a cidade onde o conteúdo foi estimado para ter sido assistido. Os resultados são classificados em ordem decrescente do tempo de exibição total.

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

Os 10 vídeos mais assistidos na Europa

Essa consulta recupera os 10 vídeos mais assistidos na Europa, entre os reivindicados pelo proprietário do conteúdo, medidos pelo número de visualizações durante o período especificado. A consulta pode ser modificada para solicitar dados de outro continente escolhendo outro valor válido para esse filtro. Da mesma forma, a consulta pode ser modificada para recuperar dados de um subcontinente, como a Europa Ocidental ou o Sudeste Asiático, usando o filtro subContinent e um dos valores válidos. Os resultados são classificados por contagem de visualizações em ordem decrescente.

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

Relatórios de playlists

Métricas de tempo de exibição específicas por país para as playlists de um proprietário de conteúdo

Essa consulta recupera as contagens de visualizações de playlist específicas do país e as métricas de tempo de exibição de playlist para todas as playlists nos canais do proprietário do conteúdo. O relatório retorna uma linha de dados para cada país em que as playlists foram assistidas. As linhas são classificadas em ordem decrescente do número de minutos assistidos.

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

10 mais – Playlists mais iniciadas nos Estados Unidos

Esta consulta recupera as 10 playlists dos canais do proprietário do conteúdo que os espectadores nos Estados Unidos começaram a assistir com mais frequência durante o período especificado. Os resultados são classificados pelo número de inícios de playlist em ordem decrescente.

Observação:como esse relatório usa a dimensão playlist, é necessário especificar um valor para o parâmetro de solicitação sort e também definir o parâmetro maxResults como um valor inteiro de 10 ou menos.

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

Relatórios de vídeo

Marcações "gostei" e "não gostei" por tipo de conteúdo

Essa consulta recupera o número de curtidas e de não curtidas para cada tipo de conteúdo em um canal ou grupo de canais específico. Para executar essa consulta no APIs Explorer, você precisa substituir a string CHANNEL_ID no valor de parâmetro filters por uma lista separada por vírgulas de até 500 IDs de canais para seus canais.

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

Relatórios de vídeo

Contagens de exibições e tempo de exibição de diferentes locais de reprodução

Essa consulta recupera o número de visualizações e o tempo de exibição estimado dos vídeos enviados para um canal ou grupo de canais específico. Os resultados são agregados com base no tipo de página ou aplicativo em que as exibições de vídeo ocorreram e são classificados em ordem decrescente pela contagem de visualizações. Para executar essa consulta no APIs Explorer, substitua a string CHANNEL_ID no valor do parâmetro filters por uma lista separada por vírgulas de até 500 IDs de canal.

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

Contagem de visualizações diárias e tempo de exibição em diferentes locais de reprodução

Esta consulta recupera contagens de visualização diárias e tempo de exibição estimado nos Estados Unidos para vídeos enviados para um determinado canal ou grupo de canais. Os resultados são agrupados por dia para cada tipo de aplicativo ou página em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica inversa. Para executar essa consulta no APIs Explorer, você precisa substituir a string CHANNEL_ID no valor de parâmetro filters por uma lista separada por vírgulas de até 500 IDs de canais para seus canais.

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

10 mais – Sites de terceiros que geram o maior número de visualizações para um vídeo incorporado

Essa consulta recupera as contagens de visualizações e o tempo de exibição estimado de um vídeo ou grupo de vídeos específico. Os resultados são agrupados por site de terceiros em que o vídeo foi incorporado. Os resultados são classificados em ordem decrescente pela contagem de visualizações. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID no valor do parâmetro filters por uma lista separada por vírgulas de até 500 IDs de vídeos enviados.

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

Relatórios de playlists

Contagem de visualizações de playlists e tempo de exibição de diferentes locais de reprodução

Essa consulta recupera o número de visualizações, o tempo de exibição estimado e as reproduções de todas as playlists nos canais de um proprietário de conteúdo. Os resultados são agregados com base no tipo de página ou aplicativo em que as reproduções de vídeo ocorreram e são classificados em ordem decrescente por inícios de playlist.

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

Contagem de visualizações de playlists e tempo de exibição de diferentes locais de reprodução

Essa consulta recupera as execuções diárias de playlists, as contagens de visualizações de playlist e o tempo de exibição estimado de playlist nos Estados Unidos para todas as playlists nos canais de um proprietário de conteúdo. Os resultados são retornados para cada tipo de página ou aplicativo em que as visualizações de playlist ocorreram.

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

Relatórios de vídeo

Contagens de exibições e tempo de exibição de diferentes origens de tráfego

Esta solicitação recupera o número de visualizações e o tempo exibição estimado para os vídeos do proprietário do conteúdo. As métricas são agregadas por origem de tráfego, que descreve a maneira pela qual os usuários chegaram ao vídeo.

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

Contagem de visualizações diárias e tempo de exibição de diferentes origens de tráfego

Essa solicitação recupera as contagens de visualizações diárias e o tempo de exibição estimado diário dos vídeos do proprietário do conteúdo. As métricas são agregadas diariamente por origem de tráfego e classificadas em ordem cronológica inversa.

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

Observação:os próximos dois exemplos de relatório são compatíveis apenas com origens de tráfego específicas. Algumas das origens de tráfego VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES e NO_LINK_EMBEDDED são incompatíveis.

10 mais – Termos de pesquisa do YouTube que geram mais tráfego para um vídeo

Esta consulta recupera os 10 termos de pesquisa que geraram o maior número de visualizações a partir dos resultados da pesquisa do YouTube para um vídeo específico ou grupo de vídeos. Os resultados são classificados por contagem de visualizações em ordem decrescente. Para executar essa consulta no API Explorer, substitua a string VIDEO_ID no valor do parâmetro filters por uma lista separada por vírgulas de até 500 IDs de vídeos enviados.

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

Top 10: sites externos que geram mais tráfego para um vídeo

Essa consulta recupera os 10 sites externos que geraram mais visualizações nos resultados da Pesquisa Google para um vídeo ou grupo de vídeos específico. Os resultados são classificados por tempo de exibição estimado em ordem decrescente. Para executar essa consulta no API Explorer, substitua a string VIDEO_ID no valor do parâmetro filters por uma lista separada por vírgulas de até 500 IDs de vídeos enviados.

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

Relatórios de playlists

Contagens de visualizações de playlist e tempo de exibição de diferentes origens de tráfego em um país

Esta solicitação recupera o número de visualizações, o número de inícios e o tempo de exibição estimado da playlist para as visualizações dela em um país especificado. As métricas são agregadas por origem de tráfego, que descreve como os usuários acessaram a playlist.

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

Contagens de visualizações de playlists e tempo de exibição de diferentes origens de tráfego

Essa solicitação recupera visualizações, inícios e tempo de exibição estimado de playlists em um ou mais canais de um proprietário de conteúdo. As métricas são agregadas por origem do tráfego. Para executar essa consulta no APIs Explorer, substitua a string CHANNEL_ID no valor do parâmetro filters por uma lista separada por vírgulas de até 500 IDs de canal.

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

Relatórios de vídeo

Métricas diárias do tipo de dispositivo para vídeos reivindicados

Essa consulta recupera as contagens de visualizações diárias e o tempo de exibição estimado por tipo de dispositivo para vídeos reivindicados por um determinado proprietário do conteúdo. Os resultados são agrupados por dia para cada tipo de dispositivo em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.

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

Métricas diárias do sistema operacional para vídeos reivindicados visualizados em dispositivos móveis

Essa consulta recupera a contagem diária de visualizações e o tempo de exibição estimado por sistema operacional para visualizações de vídeos reivindicados por um proprietário de conteúdo especificado que ocorreram em dispositivos móveis. Os resultados são agrupados por dia para cada sistema operacional em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.

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

Métricas diárias do sistema operacional e do tipo de dispositivo

Essa consulta recupera a contagem de visualizações diárias e o tempo de exibição estimado dos vídeos reivindicados por um determinado proprietário de conteúdo. As estatísticas são agrupadas por sistema operacional e tipo de dispositivo. Os resultados são classificados em ordem cronológica.

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

Relatórios de playlists

Métricas de tipo de dispositivo para visualizações de playlist no sistema operacional Android

Essa consulta recupera as contagens de visualizações de playlist e o tempo de exibição estimado em dispositivos Android para playlists em um ou mais canais de um proprietário de conteúdo. Os resultados são retornados para cada tipo de dispositivo em que as visualizações de playlist ocorreram. Para executar essa consulta no Google APIs Explorer, substitua a string CHANNEL_ID no valor do parâmetro filters por uma lista separada por vírgulas de até 500 IDs de canal.

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

Métricas do sistema operacional para visualizações de playlists em dispositivos móveis

Essa consulta recupera as contagens de visualizações e o tempo de exibição estimado de playlists em dispositivos móveis para playlists em qualquer um dos canais de um proprietário de conteúdo. Os resultados são retornados para cada sistema operacional em que as visualizações de playlist ocorreram.

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

Relatórios de vídeo

Informações demográficas dos espectadores na Califórnia (idade e gênero)

Este relatório extrai estatísticas sobre a faixa etária e o gênero dos espectadores na Califórnia que assistiram o conteúdo reivindicado pelo proprietário. Os resultados são classificados por gênero e depois por faixa etária. Essa consulta pode ser modificada para recuperar as mesmas estatísticas para todos os espectadores do mundo todo ou de um país, continente, subcontinente ou outro estado dos EUA, ajustando o valor do parâmetro filters.

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

Métricas de compartilhamento, agregadas por serviço onde os vídeos foram compartilhados

Essa solicitação recupera o número de vezes que os usuários usaram o botão Share para compartilhar vídeos enviados pelo proprietário do conteúdo. Os resultados são agregados por serviço de compartilhamento (Google+, Twitter etc) e classificados em ordem decrescente do número de compartilhamentos.

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

Métricas de retenção de público de um vídeo

Esse relatório mede a capacidade de um vídeo de manter o público assistindo. O relatório só pode ser recuperado para um vídeo por vez. Para executar essa consulta no APIs Explorer, é necessário substituir a string VIDEO_ID no valor de parâmetro filters pelo ID do vídeo de um dos vídeos enviados. Os relatórios de retenção de público-alvo não permitem especificar vários valores para o filtro video.

Neste exemplo, o relatório usa o filtro audienceType para restringir a resposta para que ela contenha apenas dados de visualizações orgânicas, que são o resultado de uma ação direta do usuário, como uma pesquisa de um vídeo ou um clique em um vídeo sugerido. Por isso, o relatório não inclui dados de visualizações de anúncios TrueView in-stream ou TrueView em display. Você pode remover o filtro para recuperar os dados de retenção de público do vídeo de todos os tipos de público.

Os dados do filtro audienceType estão disponíveis desde 25 de setembro de 2013. A API não vai retornar dados para consultas que usam o filtro para tentar recuperar dados de datas anteriores. As consultas que não usam o filtro funcionam para qualquer data após 1º de julho de 2008.

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

Métricas de receita e performance de anúncios para conteúdo reivindicado

Essa solicitação recupera as métricas de receita e performance do anúncio para o conteúdo reivindicado pelo proprietário. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.

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

Métricas diárias de receita e desempenho de anúncios

Esta solicitação recupera métricas diárias de receita e desempenho de anúncios para o conteúdo reivindicado do proprietário do conteúdo.

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

Métricas de receita e performance de anúncios específicas por país

Essa solicitação recupera as métricas de receita e desempenho do anúncio específicas do país para o conteúdo reivindicado pelo proprietário. Os resultados são classificados em ordem decrescente por valor da receita, o que significa que o primeiro país listado será aquele em que o parceiro teve a maior receita estimada.

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

10 mais – Vídeos com a maior receita

Esta solicitação recupera métricas de receita e de desempenho de anúncios para os 10 vídeos reivindicados pelo proprietário do conteúdo e que tiveram a maior receita. Os resultados são classificados em ordem decrescente pelo valor da receita, o que significa que o primeiro vídeo será aquele que teve a maior receita estimada.

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

Métricas de desempenho de anúncios para diferentes tipos de anúncios

Esta solicitação recupera métricas de desempenho de anúncios para o conteúdo reivindicado do proprietário do conteúdo. Os resultados são agrupados por tipo de anúncio, o que permite comparar os valores de receita e CPM entre diferentes tipos de anúncio.

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