Integração da API do YouTube – Conecte o Analytics do seu canal
Conecte-se uma vez por meio do Google OAuth e obtenha análises sincronizadas diariamente — CPM, RPM, retenção de público e velocidade de visualização — sem nunca exportar um CSV ou visitar o YouTube Studio separadamente.
What is Integração API do YouTube and when should you use it?
Conecte-se uma vez por meio do Google OAuth e obtenha análises sincronizadas diariamente — CPM, RPM, retenção de público e velocidade de visualização — sem nunca exportar um CSV...
What is Integração API do YouTube?
A integração da API do YouTube é a principal conexão de dados do TubeAnalytics que vincula o canal do YouTube de um criador à plataforma por meio da autenticação Google OAuth 2.0. Depois de autorizado, o TubeAnalytics lê dados da API do YouTube Analytics e da API de dados do YouTube v3 — os mesmos endpoints autenticados que alimentam o YouTube Studio — para importar métricas de desempenho de vídeo, dados demográficos do público, dados de monetização e metadados do canal. O acesso a análises e metadados é somente leitura. A única exceção é o gerenciamento de comentários: o escopo `youtube.force-ssl` permite que o painel de comentários responda, modere, marque como spam e exclua comentários nos vídeos do próprio criador. O TubeAnalytics não pode enviar nem publicar vídeos, editar metadados de vídeos, alterar configurações do canal, excluir vídeos nem acessar dados não públicos além do que o criador autoriza explicitamente na tela de consentimento do OAuth. Os escopos de análise limitam o TubeAnalytics exatamente aos dados que um criador já pode ver no YouTube Studio. As sincronizações de dados são executadas diariamente. A integração da API do YouTube está disponível em todos os planos e é a base para todos os outros recursos e integrações no TubeAnalytics.
Connection Details
Connection Type
OAuth
Sync Cadence
Sincronização automática diária. Os dados históricos são importados na conexão inicial até onde a API permitir — normalmente 90 dias no Starter, 1 ano no Professional e até 5 anos no Enterprise.
Authentication Method
Google OAuth 2.0 com quatro escopos do YouTube: youtube.readonly, yt-analytics.readonly e yt-analytics-monetary.readonly (somente leitura), além de youtube.force-ssl para o gerenciamento de comentários e a leitura de faixas de legendas nos vídeos do próprio criador. A autorização pode ser revogada a qualquer momento na página de permissões da Conta do Google do criador.
Evidence and Validation
This integration summary is reviewed against product documentation and publicly available reference sources to keep integration guidance stable.
- Integration capability documentation is published across TubeAnalytics product pages.
- Connection models and data flow descriptions are documented in integration setup references.
- Compatible tool documentation is linked for validation of integration workflows.
What Integração API do YouTube includes
Autenticação OAuth com um clique
Conecte seu canal do YouTube em menos de dois minutos ao fluxo de consentimento OAuth do Google. Nenhuma chave de API para gerar, nenhum token para copiar, nenhuma configuração de desenvolvedor necessária. A conexão funciona com qualquer canal do YouTube que possua uma conta Google.
Sincronização diária automatizada de dados
Uma vez conectado, o TubeAnalytics extrai automaticamente novos dados analíticos a cada 24 horas.
Importação completa de dados históricos
Na conexão inicial, o TubeAnalytics importa os dados analíticos históricos do seu canal, remontando até onde a API do YouTube permite. O plano Starter importa 90 dias, o Professional importa 1 ano e o Enterprise importa até 5 anos de dados históricos.
Acesso seguro somente leitura
Os escopos de análise e metadados são somente leitura. O gerenciamento de comentários é o único recurso de escrita: o youtube.force-ssl permite responder e moderar comentários nos seus próprios vídeos a partir do painel. O Google protege seus endpoints de legendas com esse mesmo escopo, por isso ele também é o que permite à ferramenta de transcrições ler as faixas de legendas dos seus próprios vídeos — somente leitura, nada é gravado de volta. O TubeAnalytics não pode enviar nem publicar vídeos, editar metadados de vídeos, alterar configurações do canal nem excluir vídeos. Revogue o acesso a qualquer momento nas configurações da sua Conta do Google.
Exportação de dados em vários formatos
Todos os dados obtidos através da API do YouTube podem ser exportados como CSV, PDF ou através da API TubeAnalytics. Use dados exportados para relatórios personalizados, análise de planilhas ou para fins de arquivamento junto com seu painel ao vivo.
Recuperação automática de erros
Se a API do YouTube sofrer uma interrupção, o TubeAnalytics tentará novamente a sincronização perdida automaticamente. Um token OAuth expirado ou revogado não pode ser tentado novamente – a sincronização desse canal para até que você autorize novamente a conexão.
How to set up Integração API do YouTube
- 1
Inicie a conexão do TubeAnalytics
Navegue até Configurações > Canais no painel do TubeAnalytics e clique em “Adicionar canal”. Você é redirecionado para a tela de consentimento do OAuth do Google, onde escolhe a conta do Google associada ao seu canal do YouTube.
- 2
Revise e aprove as permissões do OAuth
O Google exibe as permissões que o TubeAnalytics solicita. Os escopos de análise, receita e metadados são somente leitura; o youtube.force-ssl permite o gerenciamento de comentários e o acesso às faixas de legendas dos canais conectados. Revise a tela de consentimento antes de selecionar “Permitir”.
- 3
TubeAnalytics importa os dados do seu canal
Após a autorização, o TubeAnalytics começa a importar o histórico analítico do seu canal. A sincronização inicial processa sua videoteca, dados de público e métricas de receita dependendo do limite de dados históricos do seu plano. A maioria dos canais é totalmente sincronizada 24 horas após a conexão.
- 4
As sincronizações diárias mantêm seus dados atualizados
O TubeAnalytics executa uma sincronização diária que atualiza todas as métricas – contagens de visualizações, tempo de exibição, contagens de assinantes, CPM, RPM e dados de engajamento – para que seu painel sempre reflita os dados mais recentes disponíveis do YouTube Analytics sem qualquer ação manual.
- 5
Gerencie e monitore sua conexão
Em Configurações > Canais, você pode iniciar uma sincronização manual. Desconecte-se a qualquer momento para interromper a coleta de dados.
- Acesso OAuth delimitado
- Escopos OAuth — somente leitura para análises e metadados; o youtube.force-ssl abrange o gerenciamento de comentários e a leitura de legendas para transcrições, ambos limitados aos seus próprios vídeos
Google OAuth Scope Documentation, 2024
Example scenarios
Illustrative examples, not customer results.
Criador baseado em dados, 45 mil assinantes
Challenge: Queria criar painéis personalizados e alertas automatizados usando dados do YouTube, mas não tinha conhecimento técnico para trabalhar diretamente com a API do YouTube Analytics.
Approach: A integração da API do YouTube cuidou de toda a autenticação da API e busca de dados automaticamente. O criador acessou seu conjunto de dados analíticos completo por meio do painel e exportações do TubeAnalytics sem escrever uma única chamada de API. Posteriormente, quando precisaram de integrações personalizadas, a API TubeAnalytics forneceu os mesmos dados sem exigir gerenciamento direto da API do YouTube.
Frequently asked questions
- O que é a integração da API do TubeAnalytics com o YouTube?
- A integração da API do YouTube é a camada de conexão que vincula seu canal do YouTube ao TubeAnalytics por meio do Google OAuth 2.0. Uma vez autorizado, o TubeAnalytics extrai dados da API do YouTube Analytics e da API de dados do YouTube v3 – os mesmos endpoints autenticados que o YouTube Studio usa – para preencher seu painel com desempenho de vídeo, público, receita e metadados. O acesso a análises e metadados é somente leitura; o gerenciamento de comentários usa também o escopo youtube.force-ssl para que você possa responder e moderar comentários nos seus próprios vídeos. A integração sincroniza automaticamente em uma frequência diária. É a conexão básica necessária para todos os recursos do TubeAnalytics e está disponível em todos os planos.
- A integração da API do YouTube é segura?
- Sim, e aqui está exatamente o que é concedido. O TubeAnalytics solicita quatro escopos do YouTube pelo Google OAuth 2.0: youtube.readonly para metadados de vídeos e canais, yt-analytics.readonly para dados de desempenho, yt-analytics-monetary.readonly para dados de receita e youtube.force-ssl para o gerenciador de comentários e a ferramenta de transcrições. Os três primeiros são somente leitura. O youtube.force-ssl é um escopo de leitura/gravação e é usado para duas coisas: responder, moderar, marcar como spam e excluir comentários nos seus próprios vídeos a partir do painel de comentários, e ler as faixas de legendas usadas pela ferramenta de transcrições — o Google protege seus endpoints de legendas com o youtube.force-ssl, então o youtube.readonly não é suficiente para obtê-las. As transcrições usam apenas leituras. Os comentários são o único lugar em que o produto grava no YouTube — o TubeAnalytics não pode enviar nem publicar vídeos, editar títulos, descrições, tags ou miniaturas, alterar configurações do canal nem excluir vídeos. Você pode revisar e revogar o acesso a qualquer momento na página “Apps de terceiros com acesso à conta” da sua Conta do Google. O TubeAnalytics também criptografa todos os tokens OAuth em repouso e os renova de acordo com o cronograma de expiração de tokens do Google.
- Quanto tempo leva a sincronização inicial de dados?
- A sincronização inicial normalmente é concluída em 24 horas para a maioria dos canais. Durante esse período, o TubeAnalytics importa os metadados da sua videoteca, o histórico analítico, os dados demográficos do público e os dados de receita, desde o limite permitido pelo seu plano (90 dias Starter, 1 ano Professional, 5 anos Enterprise). A sincronização é executada em segundo plano – você pode fechar o navegador e retornar mais tarde para encontrar seus dados prontos. Após a importação inicial, as sincronizações incrementais diárias levam apenas alguns minutos para processar novos dados, pois só extraem atualizações desde a última sincronização bem-sucedida.
- O que acontece se meu token OAuth expirar?
- Os tokens Google OAuth expiram após um período definido (normalmente de 6 a 12 meses, dependendo do tipo de token) ou se você alterar a senha da sua conta do Google. Quando um token expira, o TubeAnalytics detecta a falha na sincronização e interrompe a sincronização desse canal até que você autorize novamente a conexão.
- Posso conectar vários canais do YouTube a uma conta TubeAnalytics?
- Sim. TubeAnalytics oferece suporte a conexões de vários canais em uma única conta. O plano Starter oferece suporte a 1 canal, o Professional oferece suporte a até 3 canais e o Enterprise oferece suporte a até 5 canais. Cada canal passa por seu próprio fluxo de autorização OAuth e é gerenciado de forma independente em Configurações > Canais. As visualizações multicanal estão disponíveis nos planos Professional e Enterprise, permitindo que você veja métricas agregadas de todos os canais conectados em uma única visualização de painel.
- Quais dados a integração da API do YouTube extrai?
- A integração extrai análises em nível de vídeo (visualizações, tempo de exibição, CTR, duração média da visualização), dados de público (dados demográficos, curvas de retenção, espectadores novos versus recorrentes), métricas de receita (CPM, RPM, desempenho do tipo de anúncio, receita estimada), detalhamentos de origem de tráfego (navegação, pesquisa, sugerido, externo, notificações) e metadados de vídeo (títulos, descrições, tags, datas de publicação, miniaturas). O conjunto de dados exato disponível depende da retenção de dados da API do YouTube Analytics e do nível do seu plano TubeAnalytics. Todos os dados correspondem ao que você vê no YouTube Studio, já que ambas as plataformas usam os mesmos endpoints de API.
Try Integração API do YouTube free for 30 days
Payment info required. Available on all plans.