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 dos parâmetros 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 vincula e preenche o Google APIs Explorer 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 Explorador de APIs, você ainda precisa especificar o canal ou proprietário de conteúdo para o qual você está extraindo 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, você pode mudar MINE para o ID do canal do usuário autenticado. Para relatórios do proprietário do conteúdo, substitua CONTENT_OWNER_ID pelo seu 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.
- Classificar solicitações por várias dimensões/métricas
- Relatórios de canais
- Relatórios de proprietários de 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 de tráfego dos vídeos de um canal específico. 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,-viewsNa resposta, os resultados são classificados cronologicamente. No conjunto de resultados de cada dia, os resultados são classificados em ordem decrescente pela 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
Contagem total de visualizações, tempo de exibição estimado e muito 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,averageViewDurationContagens de visualizações específicas por 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==US10 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: para gerar esse relatório, é necessário especificar um valor para o parâmetro de solicitação sort e definir o parâmetro maxResults como um valor inteiro de 10 ou menos.
dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatchedTop 10: taxas de cliques em anotações dos vídeos mais assistidos 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 vai aparecer primeiro.
Observação: para gerar esse relatório, é necessário especificar um valor para o parâmetro de solicitação sort e definir o parâmetro maxResults como um valor inteiro de 10 ou menos.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-viewsRelatórios de playlists
Total de visualizações de playlist de um canal
Essa solicitação recupera o total de inícios de playlist, minutos assistidos estimados, visualizações (uma métrica de vídeo agregada), visualizações de playlist (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