Esta página mostra exemplos de solicitações da API YouTube Analytics. Cada exemplo descreve brevemente o relatório que está sendo recuperado e mostra os valores de parâmetro dimensions, metrics, filters e sort correspondentes. Os documentos relatórios de canal e relatórios do proprietário do conteúdo identificam os relatórios que a API suporta.
Cada exemplo está vinculado ao APIs Explorer do Google e o preenche com os valores mostrados. Os exemplos também usam datas padrão de início e término (YYYY-MM-DD) de 2023-09-01 e 2024-03-31.
Depois de vincular ao APIs Explorer, você ainda precisará especificar o canal ou o proprietário do conteúdo para o qual está recuperando relatórios. O APIs Explorer preencherá o valor do parâmetro ids com channel==MINE ou contentOwner==CONTENT_OWNER_ID, dependendo da consulta em que você clicou. Para relatórios de canal, altere MINE para o ID do canal do usuário autenticado. Para relatórios do proprietário do conteúdo, é necessário substituir CONTENT_OWNER_ID pelo ID de proprietário do conteúdo.
Você também precisa ser autenticado como o canal especificado ou proprietário do conteúdo para que o APIs Explorer possa autorizar suas solicitações de API usando OAuth 2.0.
- Como classificar solicitações por várias dimensões/métricas
- Relatórios de canal
- Relatórios do proprietário do conteúdo
Como classificar solicitações por várias dimensões/métricas
A API é compatível com a capacidade de classificar dados de resposta usando várias dimensões ou métricas. Por exemplo, a solicitação abaixo recupera dados diários de origem do tráfego de vídeos de um determinado canal. Cada linha no conjunto de resultados identifica o número de visualizações e o tempo de exibição estimado proveniente de determinado tipo de origem de tráfego (por exemplo, EXT_URL) em um dia específico.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
Na resposta, os resultados são classificados cronologicamente. Dentro do conjunto de resultados de cada dia, os resultados são classificados em ordem decrescente por contagem de visualizações. Dessa forma, a primeira linha do conjunto de resultados contém dados para a origem de tráfego que gerou o maior número de visualizações no primeiro dia do período solicitado. A segunda linha contém dados para a origem de tráfego que gerou o segundo maior número de visualizações no primeiro dia.
Relatórios de canal
Relatórios de vídeo
Contagens totais de visualizações, tempo de exibição estimado e mais para um canal
Esta consulta recupera métricas agregadas para o conteúdo do 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,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Contagens de visualizações específicas de um país (e mais) para um canal
Esta consulta recupera métricas para um país específico para vídeos 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,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
10 mais – Vídeos mais assistidos para um canal
Esta consulta recupera os 10 vídeos mais assistidos de um canal, conforme medido pela estimativa de minutos assistidos durante o período especificado. Os resultados são classificados pela estimativa de minutos assistidos em ordem decrescente.
Observação:neste 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=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
10 mais – Taxas de cliques de anotação para os vídeos mais visualizados de um canal
Esta solicitação recupera contagens de visualização, taxas de clique de anotação, taxas de fechamento de anotação e impressões de anotação para os 10 vídeos mais visualizados do canal. Os resultados são classificados por contagem de visualizações em ordem decrescente, o que significa que o vídeo mais assistido será listado primeiro.
Observação:neste 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,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Relatórios de playlists
O total de visualizações da playlist em um canal
Esta solicitação recupera o total de inicializações da playlist, a estimativa de minutos assistidos, as visualizações (uma métrica de vídeo agregada), visualizações de playlists (uma métrica na playlist) e visualizações por início de playlist para playlists no canal do usuário autenticado.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Estatísticas de uma playlist específica
Esta solicitação recupera o total de inicializações da playlist, a estimativa de minutos assistidos, as visualizações (uma
métrica de vídeo agregada),
visualizações de playlists (uma métrica na playlist)
e visualizações por início de playlist específica. Para executar essa consulta nas APIs,
Explorer, substitua a string PLAYLIST_ID em filters
com o ID de uma playlist no canal do usuário autenticado.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Para recuperar estatísticas agregadas de várias playlists, você também pode substituir a string PLAYLIST_ID por uma lista separada por vírgulas de até 500 IDs de playlists para playlists no canal do usuário autenticado.
10 mais – Playlists mais assistidas para um canal
Esta consulta recupera as 10 playlists mais assistidas de um canal, conforme medidas pelas visualizações da playlist durante o período especificado. Ele também recupera várias outras métricas da playlist, como o número de vezes que os espectadores iniciaram a reprodução de cada lista de reprodução e a média o tempo que um espectador passou assistindo os vídeos na playlist depois que ela foi iniciada. Resultados são são classificados por visualizações 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 definir o parâmetro maxResults como um valor inteiro de 10 ou menos.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Relatórios de vídeo
Métricas diárias de tempo de exibição para vídeos de um canal
Esta consulta recupera contagens de visualização diárias, métricas de tempo de exibição e contagens de novas inscrições para os 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 da playlist em um canal
Esta solicitação recupera contagens diárias de visualização (uma métrica de vídeo agregada), visualizações de playlists (uma métrica na playlist) inicializações de playlist, estimativa de minutos assistidos e visualizações por início de playlist para os usuários autenticados canal do usuário. 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
Esta consulta recupera contagens de visualização específicas de um país, métricas de tempo de exibição e números de inscrições 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 por província para os estados dos EUA e Washington D.C.
Esta solicitação recupera um detalhamento por província com contagens de visualização, minutos assistidos estimados e duração média da visualização 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 por província. códigos ISO 3166-2.
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: neste 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
Esta consulta recupera uma lista das 10 cidades dos EUA que foram responsáveis pelo maior número de visualizações do conteúdo do canal 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 da Ásia, usando o filtro subContinent e um dos valores válidos dele. 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
Esta consulta recupera uma lista das 10 cidades dos EUA que representaram o maior número de 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
Esta consulta recupera uma lista dos dez dias mais acessados 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 do canal. 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=country==US
maxResults=10
sort=-estimatedWatchTime
10 mais – Vídeos mais visualizados na Europa
Esta consulta recupera os 10 vídeos mais assistidos do canal na Europa, conforme medido pelo número de visualizações durante o período especificado. A consulta pode ser modificada para solicitar dados de outro continente escolhendo um 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 da Ásia, usando o filtro subContinent e um dos valores válidos dele. Os resultados são classificados por contagem de visualizações em ordem decrescente.
Observação:neste 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
Esta consulta recupera contagens de visualização específicas do país (uma métrica de vídeo agregada), visualizações de playlists (uma métrica na playlist) e as métricas de tempo de exibição para as 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
10 mais – Playlists mais iniciadas nos Estados Unidos
Esta 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 por 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 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 reproduções do vídeo ocorreram e classificados em ordem decrescente por 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
Esta consulta recupera contagens de visualização diárias e tempo de exibição estimado nos Estados Unidos para vídeos de determinado canal. 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
Esta consulta recupera as contagens de visualização e o tempo de exibição estimado para um vídeo específico ou grupo de vídeos. Os resultados são agrupados por site de terceiros em que o vídeo foi incorporado. Os resultados são classificados em ordem decrescente por contagem de visualizações. 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 um ou mais IDs dos vídeos enviados.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Relatórios de playlists
Contagens de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera o número de contagens de visualizações (uma métrica de vídeo agregada), visualizações de playlists (uma métrica na playlist) tempo de exibição estimado e o início da lista de reprodução para listas de reprodução de um canal específico. Resultados são agregados com base no tipo de página ou aplicativo em que as reproduções do vídeo ocorreram e os resultados são classificados em ordem decrescente por inícios de playlist.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Contagens diárias de visualizações em playlists e tempo de exibição em diferentes locais de reprodução
Esta consulta recupera inícios de playlist diários, contagens de visualizações (um métrica de vídeo agregada), visualizações de playlists (uma métrica na playlist) e o tempo de exibição estimado nos Estados Unidos para playlists de determinado canal. Resultados são agrupados por dia para cada tipo de página ou aplicativo em que as visualizações de lista de reprodução ocorreram. 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
Esta 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
Esta solicitação recupera as contagens de visualização diárias e o tempo de exibição diário estimado para os 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
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 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, você precisa substituir a string VIDEO_ID no valor de parâmetro filters por uma lista separada por vírgulas de até 500 IDs de vídeos.
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
10 mais – Sites externos que geram o maior tráfego para um vídeo
Esta consulta recupera os 10 sites externos que geraram o maior número de visualizações para um vídeo específico ou grupo de vídeos. 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) o início da playlist e o tempo de exibição estimado para as visualizações dela em um país específico. O as métricas são agregadas por origem do tráfego, que descreve como os usuários chegaram à playlist.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Contagens de visualizações diárias da playlist e tempo de exibição de diferentes origens de tráfego
Esta solicitação recupera as visualizações diárias da playlist de um canal (uma in-playlist), início da playlist e tempo de exibição estimado. 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
Esta consulta recupera contagens de visualizações diárias e tempo de exibição estimado em dispositivos Android para vídeos de determinado canal. 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
Esta consulta recupera contagens de visualizações diárias e tempo de exibição estimado em dispositivos móveis para 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
Esta consulta recupera contagens de visualizações diárias e tempo de exibição estimado para 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 do tipo de dispositivo para visualizações de playlist no sistema operacional Android
Essa consulta recupera visualizações diárias (uma métrica de vídeo agregada), visualizações de playlists (uma métrica na playlist) e tempo de exibição estimado em dispositivos Android para listas de reprodução de um canal específico. Resultados são agrupadas por dia para cada tipo de dispositivo em que as visualizações da 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 playlists em dispositivos móveis
Essa consulta recupera visualizações diárias (uma métrica de vídeo agregada), visualizações de playlists (uma métrica na playlist) e tempo de exibição estimado em dispositivos móveis para listas de reprodução de um canal específico. Resultados são agrupadas 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 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=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)
Este relatório mostra estatísticas sobre a faixa etária e o sexo dos espectadores da Califórnia que
assistiu às playlists do canal. Os resultados são classificados por gênero e depois por faixa etária. Isso
consulta poderia ser modificada para recuperar as mesmas estatísticas para todos os espectadores ao redor do mundo ou para todos
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
Esta solicitação recupera o número de vezes que os usuários usaram o botão Share para compartilhar 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
Este relatório mede a capacidade de um vídeo de reter seu público. Só é possível recuperar o relatório de 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 não são compatíveis com a capacidade de 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. Assim, o relatório não inclui dados de visualizações de anúncios TrueView in-stream ou TrueView in-display. É possível remover o filtro para recuperar os dados de retenção de público do vídeo de todos os tipos.
Os dados do filtro audienceType estão disponíveis desde 25 de setembro de 2013. A API não retornará dados de consultas que usam o filtro para tentar recuperar dados de datas anteriores. As consultas que não usam o filtro funcionam para qualquer data posterior a 1o de julho de 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Receita do canal e métricas de performance de anúncios
Esta solicitação recupera as métricas de receita e de desempenho de anúncios 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 diárias de receita e desempenho de anúncios
Esta solicitação recupera as métricas diárias de receita e de desempenho de anúncios 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 do país
Esta solicitação recupera as métricas de receita e de desempenho de anúncios específicas do país de um canal. 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 líquida.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks 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 do canal com a maior receita. Os resultados são classificados em ordem decrescente por 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 a receita e os valores de CPM em diferentes tipos de anúncio.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Relatórios do proprietário do conteúdo
Relatórios de vídeo
Contagens totais de visualizações, tempo de exibição estimado e mais para todo o conteúdo reivindicado
Esta consulta recupera métricas agregadas para o conteúdo reivindicado do proprietário do conteúdo. 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,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
Contagens de visualização específicas de um país (e mais) para todos os vídeos enviados automaticamente
Esta consulta recupera métricas para um país específico para os vídeos que o proprietário do conteúdo enviou. 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,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Contagens total de visualizações (e mais) para todo o conteúdo de terceiros reivindicado
Esta consulta recupera métricas agregadas para os vídeos que o proprietário do conteúdo reivindicou, mas não enviou. 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,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Contagens total de visualizações (e mais) para todo o conteúdo enviado automaticamente
Esta consulta recupera métricas agregadas para os vídeos que o proprietário do conteúdo enviou. 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,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
Contagens totais de visualizações (e mais) para todo o conteúdo enviado automaticamente
Esta consulta recupera métricas agregadas para os vídeos que o proprietário do conteúdo enviou e reivindicou. 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,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
10 mais – Vídeos mais visualizados para um proprietário do conteúdo
Esta consulta recupera os 10 vídeos mais visualizados, conforme medido pelo número de visualizações durante o período especificado, que o proprietário do conteúdo enviou. Os resultados são classificados por contagem de visualizações em ordem decrescente.
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
10 mais – Vídeos mais assistidos para um proprietário do conteúdo
Esta consulta recupera os 10 vídeos mais assistidos, conforme medido pela estimativa de minutos assistidos durante o período especificado. Os resultados são classificados pela estimativa de minutos assistidos em ordem decrescente.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
10 mais – Vídeos mais visualizados para o canal de um proprietário de conteúdo
Esta consulta recupera os 10 vídeos mais visualizados para um canal específico ou grupo de canais que o proprietário do conteúdo gerencia. Os resultados são classificados por contagem de visualizações em ordem decrescente. 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=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 mais – Taxas de cliques de anotação para os vídeos mais visualizados de um canal
Esta solicitação recupera contagens de visualização, taxas de clique de anotação, taxas de fechamento de anotação e impressões de anotação para os 10 vídeos mais visualizados em um canal ou grupo de canais especificado. Os resultados são classificados por contagem de visualizações em ordem decrescente, o que significa que o vídeo mais assistido será listado primeiro. 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=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Relatórios de playlists
Visualizações de playlist nos canais de um proprietário de conteúdo
Esta solicitação recupera o total de inicializações da playlist, a estimativa de minutos assistidos e a playlist
visualizações e visualizações por playlist começam para as playlists nos canais do proprietário do conteúdo. O
A métrica playlistViews contabiliza apenas as exibições de vídeos que ocorreram no contexto de um
lista de reprodução. Como todas as métricas solicitadas são métricas na playlist, a solicitação não
também precisa incluir o filtro playlist ou grupo.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Estatísticas de uma playlist específica
Esta solicitação recupera o total de inicializações da playlist, a estimativa de minutos assistidos, as visualizações (uma
métrica de vídeo agregada),
visualizações de playlists (uma métrica na playlist)
e visualizações por início de playlist específica. Para executar essa consulta nas APIs,
Explorer, substitua a string PLAYLIST_ID em filters
com o ID de uma playlist em um dos canais do proprietário do conteúdo.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Para recuperar estatísticas agregadas de várias playlists, você também pode substituir a string PLAYLIST_ID por uma lista separada por vírgulas de até 500 IDs de playlists para playlists nos canais do proprietário do conteúdo.
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
Esta solicitação recupera contagens diárias de visualização, taxas de cliques de anotação, taxas de fechamento de anotação e impressões de anotação para o conteúdo reivindicado do proprietário do conteúdo. 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 da playlist de um proprietário do conteúdo
Esta solicitação recupera métricas para as interações diárias do usuário com os vídeos na rede do proprietário do conteúdo listas de reprodução. 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 métricas na playlist, a solicitação não precisa inclua também 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 de publicidade estimada 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
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 enviados do 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 por província para os estados dos EUA e Washington D.C.
Esta solicitação recupera um detalhamento por província com as contagens de visualização, com a estimativa de minutos assistidos e a duração média da visualização dos vídeos reivindicados do 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 por província. códigos ISO 3166-2.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
As 10 principais cidades dos EUA por visualizações totais
Esta consulta recupera uma lista das 10 cidades dos EUA que foram responsáveis pelo maior número de visualizações dos vídeos reivindicados do 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 da Ásia, usando o filtro subContinent e um dos valores válidos dele. 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
Esta consulta recupera uma lista das dez cidades dos EUA que representaram o maior número de visualizações do conteúdo reivindicado do proprietário do conteúdo 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 total de exibição.
dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime
10 mais – Vídeos mais assistidos na Europa
Esta consulta recupera os 10 vídeos mais assistidos na Europa, entre os vídeos reivindicados pelo proprietário do conteúdo, conforme medido pelo número de visualizações durante o período especificado. A consulta pode ser modificada para solicitar dados de outro continente escolhendo um 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 da Ásia, usando o filtro subContinent e um dos valores válidos dele. 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 do país para as playlists de um proprietário do conteúdo
Esta consulta recupera contagens de visualização de playlist específicas do país e métricas de tempo de exibição de playlist para todas as listas de reprodução nos canais do proprietário do conteúdo. O relatório retorna uma linha de dados para cada país onde as playlists foram assistidas. As linhas são classificadas em ordem decrescente de 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 do Os Estados Unidos começaram a assistir conteúdo com mais frequência durante o período especificado. Resultados são classificado por número de inícios da playlist em ordem decrescente.
Observação: como este relatório usa o
playlist, é necessário
especificar um valor para o parâmetro de solicitação sort e também definir o
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
Esta consulta recupera o número de marcações "gostei" e "não gostei" para cada tipo de conteúdo em um determinado canal ou grupo de canais. 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
Esta consulta recupera o número de visualizações e o tempo de exibição estimado para vídeos enviados para um determinado canal ou grupo de canais. Os resultados são agregados com base no tipo de página ou aplicativo em que as reproduções do vídeo ocorreram e classificados em ordem decrescente por contagem de visualizações. 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=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Contagens de visualizações diárias e tempo de exibição de 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
Esta consulta recupera as contagens de visualização e o tempo de exibição estimado para um vídeo específico ou grupo de vídeos. Os resultados são agrupados por site de terceiros em que o vídeo foi incorporado. Os resultados são classificados em ordem decrescente por contagem de visualizações. 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=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Relatórios de playlists
Contagens de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera o número de visualizações da lista de reprodução, o tempo de exibição estimado da lista de reprodução e playlist é iniciada para todas as listas de reprodução nos canais do proprietário do conteúdo. Os resultados são agregados com base com base no tipo de página ou aplicativo em que as reproduções do vídeo ocorreram e os resultados são classificados ordem decrescente por inícios de playlist.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Contagens de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera as inicializações diárias da playlist, as contagens de visualizações da playlist e a estimativa de visualizações da playlist tempo nos Estados Unidos para todas as listas de reprodução nos canais do proprietário do conteúdo. Os resultados são retornados para cada tipo de página ou aplicativo em que as visualizações da lista de reprodução 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
Contagens de visualizações diárias e tempo de exibição de diferentes origens de tráfego
Esta solicitação recupera as contagens de visualização diárias e o tempo de exibição diário estimado para os 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. Por exemplo, a origem do tráfego NO_LINK_EMBEDDED não tem detalhes adicionais e, portanto, esses relatórios não estão disponíveis para ela. Consulte a definição de insightTrafficSourceType para ver detalhes sobre as origens de tráfego para as quais esses tipos de relatório estão disponí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 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=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 mais – Sites externos que geram o maior tráfego para um vídeo
Esta consulta recupera os 10 sites externos que geraram o maior número de visualizações a partir dos resultados da pesquisa do Google para um vídeo específico ou grupo de vídeos. 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;
Esta solicitação recupera o número de visualizações, de inícios e de visualização da playlist estimada das visualizações da playlist em um país específico. As métricas são agregadas por origem de tráfego, que descreve como os usuários chegaram à 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
Esta solicitação recupera as visualizações da playlist, os inícios de playlist e o tempo de exibição estimado da playlist
para playlists em um ou mais canais do proprietário do conteúdo. As métricas são agregadas por
origem do tráfego. Para executar essa consulta no APIs Explorer, você precisa substituir a string
CHANNEL_ID no valor de parâmetro filters por uma vírgula separada
lista de até 500 IDs de canais para seus canais.
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
Esta consulta recupera contagens de visualizações diárias e tempo de exibição estimado por tipo de dispositivo para vídeos reivindicados por um proprietário de conteúdo 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=claimedStatus==claimed sort=day
Métricas diárias do sistema operacional para vídeos reivindicados visualizados em dispositivos móveis
Esta consulta recupera contagens de visualizações diárias e 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
Esta consulta recupera contagens de visualização diárias e tempo de exibição estimado para vídeos reivindicados por um proprietário de conteúdo específico. 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
Esta consulta recupera as contagens de visualização da playlist e o tempo de exibição estimado da playlist em dispositivos Android
para playlists em um ou mais canais do proprietário do conteúdo. Os resultados são retornados para
cada tipo de dispositivo em que as visualizações da playlist ocorreram. Para executar essa consulta nas APIs,
Explorer, substitua a string CHANNEL_ID em filters
valor do parâmetro com uma lista separada por vírgulas de até 500 IDs de canais para seus canais.
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
Esta consulta recupera as contagens de visualização da playlist e o tempo de exibição estimado da playlist em dispositivos móveis para playlists em qualquer um dos canais do proprietário do conteúdo. Os resultados são retornados para cada sistema operacional em que as visualizações da lista de reprodução 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 mostra estatísticas sobre a faixa etária e o gênero dos espectadores da Califórnia que assistiram ao conteúdo reivindicado do proprietário do conteúdo. 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
Esta solicitação recupera o número de vezes que os usuários usaram o botão Share para compartilhar vídeos que o proprietário do conteúdo enviou. 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
Este relatório mede a capacidade de um vídeo de reter seu público. Só é possível recuperar o relatório de 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 não são compatíveis com a capacidade de 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. Assim, o relatório não inclui dados de visualizações de anúncios TrueView in-stream ou TrueView in-display. É possível remover o filtro para recuperar os dados de retenção de público do vídeo de todos os tipos.
Os dados do filtro audienceType estão disponíveis desde 25 de setembro de 2013. A API não retornará dados de consultas que usam o filtro para tentar recuperar dados de datas anteriores. As consultas que não usam o filtro funcionam para qualquer data posterior a 1o de julho de 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Métricas de receita e de desempenho de anúncios para o conteúdo reivindicado
Esta solicitação recupera métricas de receita e de desempenho de anúncios para o conteúdo reivindicado do proprietário do conteúdo. 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 do país
Esta solicitação recupera métricas específicas de receita e desempenho de anúncios do país para o conteúdo reivindicado do proprietário do conteúdo. 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 por 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 a receita e os valores de CPM em diferentes tipos de anúncio.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType