YouTube

Como revisar título, descrição, tag e tradução do canal do YouTube com IA

Depois do upload automático, acrescente os scopes de edição e legenda no Google Cloud, reconecte a conta e deixe a IA revisar vídeos antigos e traduções.

Assistir ao vídeo original no YouTube
Thumbnail do vídeo: Como Revisar SEO do Canal com IA Automaticamente

No vídeo anterior eu montei o sistema que envia vídeo para o YouTube pelo chat do Codex, do Claude Code ou de outro app: você arrasta o arquivo e a miniatura, e a publicação sai com título e descrição. Aqui o assunto é o que faltava: editar o que já está no canal. Sem o scope certo, a automação só publicava. Eu pedi para a IA acrescentar autorização de edição, atualizei o consentimento no Google Cloud e reconectei a conta. Com isso ela revisou 45 vídeos públicos no canal principal — tags, descrição, hashtag — e, no canal de músicas Midplay, 26 vídeos com descrição e título em português, espanhol e japonês. Não é mágica de busca. É API, scope e uma passada humana no texto que você não escreveu.

No Google Cloud, na tela de consentimento OAuth, adicione o scope de gerenciar o YouTube e o youtube.force-ssl (comentário, legenda, capítulo). Publique o consentimento, reconecte a conta no seu sistema e peça a revisão por canal: descrição, tags, hashtag e, se o scope permitir, traduções na aba de idiomas. Tokens novos pedem login de novo. Vídeo enviado no fluxo antigo continua podendo nascer privado — mude o status depois, se a permissão existir.

O que mudou
Scopes de edição e de legenda no OAuth
Canal principal
45 vídeos públicos com tag e descrição novas
Midplay
26 vídeos, traduções em PT, ES e JA em cerca de 12 minutos

O sistema de upload não editava o que já existia

O fluxo anterior publica. Ele não tinha permissão para mexer em vídeo que já estava no canal. Eu pedi para a IA colocar no código os scopes que a autorização precisa e atualizar o sistema. No Google Cloud Console, em APIs e credenciais, na tela de consentimento OAuth, em acesso a dados, você adiciona ou remove scope. Dois entram nesta etapa.

O primeiro é o de gerenciar a conta do YouTube — na fala aparece como o scope “youtube” — e permite editar vídeos já existentes. O segundo é o youtube.force-ssl: comentário, legenda, inclusive a legenda gerada automaticamente, e a partir daí os capítulos. Com legenda a IA consegue marcar capítulo e completar o pacote da página do vídeo. Você salva e publica o consentimento. Provavelmente o app ainda não está aprovado pelo Google. A tela avisa que o app não foi verificado; em modo de teste funciona para as contas de teste que você cadastrou.

  1. Abra o Google Cloud Console do mesmo projeto OAuth do upload.
  2. Vá em APIs e serviços > tela de consentimento OAuth > acesso a dados (scopes).
  3. Adicione https://www.googleapis.com/auth/youtube e https://www.googleapis.com/auth/youtube.force-ssl.
  4. Salve e publique o consentimento. Em teste, o aviso de app não verificado é esperado.
  5. Atualize os mesmos scopes no seu Worker ou script; a IA do projeto faz isso se você pedir edição e legenda.

Token, renovação e a reconexão obrigatória

No vídeo anterior eu tinha dito que o token expirava no mesmo dia. A IA criou renovação automática, para não passar de novo pela tela o tempo todo. No sistema, o botão renovar reativa a conta. Mesmo assim, depois de ligar scope novo no Cloud e no código — seja no Antigravity, no Codex ou no app que você usou — você reconecta. Sem reconectar, a conta antiga não tem as permissões novas. É um login de autorização, não um capricho.

O projeto, no meu caso, tem duas metades. Uma está na Cloudflare, no ar. A outra é local, em Python, e faz a ponte com o Worker para enviar o vídeo via login Google da conta do YouTube. Se a IA estiver numa subpasta e ignorar a regra da raiz, ela tenta caminho torto — na gravação ela quis usar outra saída em vez da automação do projeto. Vale deixar a instrução do repositório visível. Sem isso ela improvisa.

45 vídeos no canal principal, com o texto que eu não escrevi

No Codex eu pedi para revisar as tags do canal. Ela passou em 45 vídeos, mexeu em tag e deixou a descrição mais cheia. Só nos públicos. No canal em que você está assistindo, eu abri um vídeo: com certeza não fui eu que escrevi aquele bloco. Tinha hashtag visível e um monte de tag. Dá para conversar com a ferramenta, pedir o critério, mandar parar o que estiver errado. Eu não tratei o texto automático como intocável. Tratei como rascunho em massa para canal antigo em que eu tinha preguiça de descrição.

Hashtag interna, tag da API e descrição rica são coisas diferentes. A IA mistura se você não separar. O lugar de conferir é a página do YouTube Studio, vídeo a vídeo numa amostra, não o “pronto” no chat.

O canal Midplay: upload no meio, revisão em 12 minutos, três idiomas

Abri um segundo canal, de músicas, o Midplay. Mandei um vídeo com miniatura — o tipo que pega um MIDI e vira a versão tocada, no estilo que eu já mostrei em outro vídeo. A IA tentou um caminho sem a automação do projeto; eu recortei e apontei para o script local. O envio concluiu: no ar, em processamento, privado, porque eu não pedi público. Título e descrição em inglês, no recorte que eu tinha combinado. Link na descrição: ela colocou busca para o site, não o endereço direto. Dá para corrigir na conversa. Status depois se muda no Studio, se o token não tiver permissão de visibilidade — esse furo eu já tinha visto no vídeo do upload.

Em seguida pedi a revisão do Midplay: description, tags e hashtags em inglês, porque o site é em inglês; e, se o scope deixasse, títulos e descrições em outros idiomas na aba de traduções. Alcance internacional. Deixei o modelo no médio para não gastar o limite inteiro de uma vez; se não terminasse, continuava depois. Pulei na edição: cerca de doze minutos para revisar os 26 vídeos. Entrou o bloco “learn / aprenda”, o link do canal que eu não colocava por preguiça, o texto da prática no teclado. Em espanhol, japonês e português a descrição apareceu. O título em japonês ela manteve em inglês onde não havia o que transcriar. Fazer a tradução na aba do YouTube, no meu uso, ainda vale mesmo que a plataforma ofereça tradução automática: você acerta o termo que aquele idioma busca.

  • Scope novo + reconexão antes de pedir edição em lote.
  • Amostra no Studio: descrição, tag, hashtag e aba de idiomas.
  • Upload novo pode nascer privado; revisão de canal antigo não muda isso sozinha.
  • Instrução do repositório na raiz, para a IA não furar a automação e ir pelo atalho errado.

O que você precisa no Cloud Console e o que é conversa

Se o projeto nasceu no Codex e você já disse que a ferramenta edita, ela acrescenta os scopes no código. O que não é automático é o Cloud Console: os mesmos scopes têm que existir no consentimento. Sem isso o login não pede a permissão nova. Capítulo a partir da legenda, tradução na aba, tag em 45 vídeos — tudo isso é a API com o token certo, não um botão nativo do YouTube Studio acionado por chat.

Para tarefa repetida, uma regra no repositório evita trabalho errado e gasto de limite. Para coisa simples, conversar resolve. Eu não tratei engenharia de mensagem como obrigação neste fluxo. Tratei como cuidado quando o lote é grande e o canal não é de teste. No fechamento, dúvida no grupo de WhatsApp.

Na sequência

  1. Ter o sistema de upload e login Google funcionando no Worker e no script local.
  2. Incluir os scopes youtube e youtube.force-ssl no consentimento e no código.
  3. Reconectar a conta depois do scope novo; renovar token não substitui isso.
  4. Pedir a revisão por canal, com idioma e o que pode ou não traduzir.
  5. Abrir uma amostra no YouTube Studio, inclusive a aba de idiomas, antes de soltar o lote no canal principal.

Onde isso quebra

Pedir edição em lote sem reconectar: o token antigo não tem a permissão nova.

Deixar a IA escrever descrição em canal sério sem ler uma amostra — no meu principal o texto claramente não era meu.

Confundir hashtag visível, tag da API e tradução na aba de idiomas.

Achar que revisão de metadados publica o privado ou troca visibilidade: no fluxo anterior o token já tinha falhado nisso.

Deixar a IA numa subpasta sem a regra da raiz: ela fura a automação e tenta outro caminho.

Perguntas frequentes

Quais scopes o Google pede para editar vídeo antigo e criar capítulo?

O scope de gerenciar o YouTube para editar o que já existe, e o youtube.force-ssl para comentário, legenda e, a partir da legenda, capítulo. Os dois entram no consentimento OAuth e no código.

Por que reconectar se o token já renova sozinho?

Renovação prolonga a autorização antiga. Scope novo só entra num consentimento novo. Sem o segundo login, a conta continua limitada ao que valia no upload.

A IA traduz a página do vídeo ou só a descrição em inglês?

No Midplay ela preencheu a aba de idiomas (português, espanhol, japonês) além do texto principal em inglês. O título em japonês ficou em inglês onde ela não viu o que transcriar. Confira no Studio, não só no chat.

Quanto tempo levou a revisão do canal de músicas?

Cerca de doze minutos para 26 vídeos, no modelo médio. Canal maior e modelo mais alto mudam o relógio e o gasto de limite.

Isso substitui o YouTube Studio?

Não. Studio continua sendo onde você vê o que foi gravado na API. A automação evita a preguiça de descrição vazia e de tag em dezenas de vídeos antigos.

O login OAuth e o envio do arquivo estão em como automatizar o upload no YouTube com IA. O mesmo tipo de conector, com várias APIs do Google numa conta só, está em APIs do Google em um conector na Cloudflare.