API Reference

A API YouTube Analytics permite que você extraia dados do YouTube Analytics para um canal ou proprietário de conteúdo do YouTube. A API oferece suporte a consultas em tempo real e gera um relatório com base nos parâmetros de solicitação da API.

A API aceita dois tipos de funções:

  • Recuperação de relatórios: o método reports.query da API recupera relatórios do YouTube Analytics.

  • Gerenciamento de grupos do YouTube Analytics: um grupo do YouTube Analytics é uma coleção personalizada de até 500 canais, vídeos, playlists ou recursos. A API oferece suporte a vários métodos para criar, extrair e atualizar grupos do YouTube Analytics. Os proprietários de canais e de conteúdo podem usar o método reports.query para extrair dados agregados de todos os itens de um grupo, o que pode ajudar na análise de performance.

Esta página oferece uma breve visão geral dos recursos e métodos da API que ativam essas funções.

Autorização

Todas as solicitações da API YouTube Analytics precisam ser autorizadas. O guia de autorização explica como usar o protocolo OAuth 2.0 para recuperar tokens de autorização.

As solicitações da API YouTube Analytics usam os seguintes escopos de autorização:

Escopos
https://www.googleapis.com/auth/yt-analytics.readonly Visualizar os relatórios do YouTube Analytics para seu conteúdo do YouTube. Este escopo fornece acesso às métricas de atividade do usuário, como contagens de visualização e de classificação.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Visualizar os relatórios monetários do YouTube Analytics para seu conteúdo do YouTube. Esse escopo dá acesso às métricas de atividade do usuário e às métricas de receita estimada e performance do anúncio.
https://www.googleapis.com/auth/youtube Gerenciar sua conta do YouTube. Na API YouTube Analytics, os proprietários de canais usam esse escopo para gerenciar grupos e itens de grupo do YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Acessar e gerenciar recursos e conteúdos associados no YouTube. Na API YouTube Analytics, os proprietários de conteúdo usam esse escopo para gerenciar grupos e itens de grupo do YouTube Analytics.

Recuperar relatório

O método reports.query da API permite recuperar muitos relatórios diferentes do YouTube Analytics. Cada solicitação usa parâmetros de consulta para especificar um ID de canal ou proprietário do conteúdo, uma data de início, uma data de término e pelo menos uma métrica. Também é possível fornecer outros parâmetros de consulta, como dimensões, filtros e instruções de classificação.

Método Solicitação HTTP Descrição
URIs relativos a https://youtubeanalytics.googleapis.com/v2
query GET /reports Recupera um relatório do YouTube Analytics. Cada solicitação de API usa parâmetros de consulta para especificar um ID de canal ou proprietário do conteúdo, uma data de início, uma data de término e pelo menos uma métrica. Você também pode fornecer outros parâmetros de consulta, como dimensões, filtros ou instruções de classificação.
  • Métricas são medidas individuais de atividade do usuário, como exibições ou classificações de vídeo (gostei e não gostei).
  • Dimensões são critérios comuns usados ​​para dados agregados, como a data em que ocorreu a atividade do usuário ou o país em que os usuários estavam localizad. Em um relatório, cada linha de dados tem uma combinação exclusiva de valores de dimensão.
  • Filtros são valores de dimensões que especificam os dados que serão recuperados. Por exemplo, é possível extrair dados de um país, um vídeo ou um grupo de vídeos específico.
As listas de relatórios de canal e de proprietários de conteúdo compatíveis definem as combinações válidas de métricas, dimensões e filtros.

Gerenciamento de grupos

A API oferece dois recursos para criar e gerenciar grupos do YouTube Analytics:

Grupos

Um recurso group representa um grupo do YouTube Analytics, que é uma coleção personalizada de até 500 canais, vídeos, playlists ou recursos.

Todos os itens de um grupo precisam representar o mesmo tipo de recurso. Por exemplo, não é possível criar um grupo com 100 vídeos e 100 playlists.

Um grupo do Google Analytics só pode conter recursos que você enviou ou reivindicou ou que estão vinculados a um canal que você administra. Assim, os proprietários de canais podem criar grupos de vídeos e playlists. Os proprietários de conteúdo podem criar grupos de vídeos, playlists, canais ou recursos.

Para obter mais informações sobre este recurso, consulte sua representação de recurso e lista de propriedades.

Método Solicitação HTTP Descrição
URIs relativos a https://youtubeanalytics.googleapis.com/v2
list GET /groups Retorna uma lista de grupos que correspondem aos parâmetros da solicitação da API. Por exemplo, é possível recuperar todos os grupos que pertencem ao usuário autenticado ou recuperar um ou mais grupos pelos IDs exclusivos.
insert POST /groups Cria um grupo do YouTube Analytics. Depois de criar um grupo, use o método groupItems.insert para adicionar itens a ele.
update PUT /groups Modifica os metadados de um grupo. No momento, a única propriedade que pode ser atualizada é o título do grupo. Use groupItems.insert e groupItems.delete para adicionar e remover itens do grupo.
delete DELETE /groups Exclui um grupo.

GroupItems

Um recurso groupItem representa um item em um grupo do YouTube Analytics.

Para obter mais informações sobre este recurso, consulte sua representação de recurso e lista de propriedades.

Método Solicitação HTTP Descrição
URIs relativos a https://youtubeanalytics.googleapis.com/v2
list GET /groupItems Retorna uma coleção de itens de grupo que correspondem aos parâmetros de solicitação da API.
insert POST /groupItems Cria um item de grupo.
delete DELETE /groupItems Remove um item de um grupo.