YouTube postar do zero: projeto no Google Cloud, OAuth, login de 7 dias e envio de vídeo pelo AFK

Para que serve no AFK

• Subir um vídeo no seu canal com título, descrição, tags e privacidade (privado, não listado ou público). Vídeo vertical curto vira Short pelo próprio YouTube.
• Pôr a capa (thumbnail) no mesmo envio.
• Como roda: por um comando no terminal do AFK (Parte 6). Nenhuma rotina do AFK posta no YouTube sozinha, e o AFK não agenda o horário de publicação. Para agendar, suba como privado e agende no YouTube Studio.
• Sem a conexão: o AFK entrega o vídeo, a capa e o texto prontos para você subir no YouTube Studio.

O AFK sobe todo vídeo na categoria Pessoas e blogs e marcado como não é conteúdo para crianças. Se o seu vídeo é para crianças, mude isso no YouTube Studio logo depois do envio.

Antes: grátis ou pago

A YouTube Data API não cobra. O limite é a cota diária do projeto e o limite do seu canal.

Cota padrão de um projeto novo, na documentação oficial, conferida em 30/10/2026:

O modo do app no Google decide quanto tempo a autorização dura:

• Vídeo preso no privado. A documentação oficial do envio diz que vídeo enviado por projeto não verificado não fica preso no modo privado (conferido em 30/10/2026). Se o YouTube travar um vídeo seu como privado, ele avisa por e-mail. Nesse caso, o caminho é a auditoria do projeto pelo formulário de auditoria e extensão de cota da API do YouTube.
• Cliente parado é apagado. O Google apaga o cliente OAuth que fica 6 meses sem uso. Dá para restaurar em até 30 dias.
• Risco de bloqueio: baixo. É a API oficial do YouTube, dentro dos termos. O que derruba canal é o conteúdo: direito autoral e spam valem igual para envio pela API.

Parte 1: conta Google, segurança e canal verificado

1. Use a conta Google dona do canal do YouTube do negócio.
2. Ligue a verificação em duas etapas. Abra myaccount.google.com/security, em Como você faz login no Google escolha Verificação em duas etapas e siga as etapas. Essa conta passa a publicar no canal: proteja como a senha do banco.
3. Verifique o canal pelo celular. No computador, abra youtube.com/verify e confirme com o código por SMS ou ligação. Sem isso, a capa personalizada é recusada e o vídeo fica limitado a 15 minutos.

Parte 2: projeto e YouTube Data API

O console do Google Cloud segue o idioma da sua conta. Os nomes abaixo estão em inglês, como na documentação do Google. Em português, o caminho é o mesmo.

1. Abra console.cloud.google.com com a conta dona do canal.
2. Use um projeto que você já tenha ou crie outro no seletor de projeto, no topo, em New project.
3. No menu, abra APIs & Services → Library, procure YouTube Data API v3 e clique em Enable.

Parte 3: tela de consentimento e usuário de teste

A tela de consentimento é o que aparece quando você autoriza o AFK a postar no canal. Você configura uma vez.

1. No menu, abra Google Auth platform → Branding. Se aparecer Get Started, clique.
2. Preencha App name (por exemplo, AFK Minha Empresa) e User support email (o seu). Clique em Next.
3. Em público, escolha External. Clique em Next.
4. Em contato, ponha o seu e-mail. Clique em Next.
5. Marque I agree to the Google API Services: User Data Policy, clique em Continue e depois em Create.
6. Abra Audience. Em Test users, clique em Add users, ponha o e-mail da conta dona do canal e salve. Só os e-mails dessa lista conseguem autorizar enquanto o app está em teste.

Parte 4: criar o cliente Desktop app e baixar o JSON

O cliente é o cadastro do AFK no seu projeto. O JSON dele é o que você cola no painel.

1. No menu, abra Google Auth platform → Clients e clique em Create Client.
2. Em Application type, escolha Desktop app. Não escolha Web application: o AFK autoriza pelo seu computador, e o cliente web recusa esse retorno.
3. Dê um nome, por exemplo AFK, e clique em Create.
4. Na janela que aparece, baixe o JSON na hora. O Google só mostra o segredo do cliente nessa janela. Fechou sem baixar: crie outro cliente.
5. O arquivo baixado tem nome parecido com client_secret_123...apps.googleusercontent.com.json.

Parte 5: colar no AFK

1. Abra o arquivo baixado no Bloco de Notas. Clique com o botão direito → Abrir com → Bloco de Notas.
2. Aperte Ctrl+A e depois Ctrl+C para copiar tudo, do { ao }.
3. No painel do AFK, abra Conexões, clique no cartão YouTube — postar sozinho, cole em Conteúdo do client_secret.json e clique em Salvar conexão.
4. O cartão não tem Testar. A prova é o primeiro envio (Parte 6).
5. Apague o arquivo baixado da pasta Downloads. O AFK guardou uma cópia em meu-negocio/credenciais/.

Parte 6: primeiro envio e autorização

Use um vídeo curto de teste. Ele sobe como privado, e só você vê.

1. Abra o terminal na pasta do AFK.
2. Se nunca rodou as ferramentas de Python do AFK, instale as bibliotecas uma vez:

   pip install -r ferramentas/comum/requirements.txt

3. Envie um vídeo de teste, como privado:

   python ferramentas/publicar/postar_youtube.py --video teste.mp4 --titulo "Teste Minha Empresa" --privacidade private

4. O navegador abre. Escolha a conta dona do canal.
5. Aparece o aviso O Google não verificou este app (em inglês, Google hasn't verified this app). É o seu próprio app. Clique em Avançado (Advanced) e no link para continuar.
6. Marque a permissão de enviar vídeos ao YouTube e clique em Continuar.
7. O terminal mostra o progresso e, no fim, Vídeo publicado: https://youtu.be/.... Abra o link e confira no YouTube Studio.

A autorização fica no arquivo meu-negocio/credenciais/token_youtube.json, no seu computador. Esse arquivo dá acesso de envio ao seu canal: não mande para ninguém.

Parte 7: parar de pedir login a cada 7 dias

Com o app em teste, a autorização vence em 7 dias. Publicar o app tira esse prazo.

1. No Google Cloud, abra Google Auth platform → Audience.
2. Clique em Publish app e confirme. O status passa para In production.
3. Apague o arquivo meu-negocio/credenciais/token_youtube.json e faça um envio. Autorize de novo, passando pelo aviso de app não verificado. A autorização nova não vence em 7 dias.

No dia a dia

Sem --privacidade, o AFK sobe o vídeo como privado.

Erros e soluções

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande o JSON nem o arquivo token_youtube.json.

Fontes oficiais (conferido em 30/10/2026): developers.google.com/youtube/v3/determine_quota_cost (100 chamadas de videos.insert por dia numa cota própria; thumbnails.set custa 50; 10.000 unidades para o resto; zera à meia-noite do Pacífico) · developers.google.com/youtube/v3/docs/videos/insert (escopo youtube.upload; até 256 GB; vídeo de projeto não verificado não fica preso no privado; status.publishAt existe na API) · developers.google.com/youtube/v3/revision_history (nota sobre vídeo de projeto não verificado no privado e a auditoria que tira essa trava; cota separada de upload e busca) · developers.google.com/youtube/v3/docs/thumbnails/set (aceita youtube.upload; JPG ou PNG até 50 MB; erro de permissão para capa personalizada) · developers.google.com/identity/protocols/oauth2 (app externo em Testing recebe token que vence em 7 dias; limite de 100 tokens por conta e cliente) · developers.google.com/workspace/guides/configure-oauth-consent (Google Auth platform → Branding, Audience, Test users → Add users) · developers.google.com/workspace/guides/create-credentials (Clients → Create Client → Desktop app) · developers.googleblog.com/en/usability-and-safety-updates-to-google-auth-platform (segredo do cliente só aparece na criação; cliente parado 6 meses é apagado, restaurável em 30 dias) · support.google.com/cloud/answer/13464323 (uso pessoal com menos de 100 usuários: verificação opcional) · support.google.com/cloud/answer/7454865 (tela de app não verificado; limite de 100 usuários; verificação pede política de privacidade e domínio no Search Console; pode levar meses) · support.google.com/youtube/answer/71673 (conta sem verificação envia vídeo de até 15 minutos; verificação por SMS ou ligação) · support.google.com/youtube/answer/72431 (capa personalizada exige conta verificada).