Exemplo de solicitações de API

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.

  1. Como classificar solicitações por várias dimensões/métricas
  2. Relatórios de canal
  3. 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

Estatísticas básicas

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
Baseado no tempo

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
Área geográfica

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
Local da reprodução

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
Detalhes de reprodução

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
Origem do tráfego

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
Dispositivo/SO

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
Demográfico

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
Redes sociais

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
Retenção de público

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/anúncios

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

Estatísticas básicas

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.

Baseado no tempo

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
Área geográfica

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
Detalhes de reprodução

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
Local da reprodução

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
Origem do tráfego

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
Dispositivo/SO

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
Demográfico

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
Redes sociais

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
Retenção de público

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/anúncios

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