Automação

Como reunir APIs do Google em um conector OAuth próprio

Veja como centralizar a autorização das suas contas Google num conector OAuth hospedado na Cloudflare e usar YouTube, Analytics e outros serviços em automações.

Assistir ao vídeo original no YouTube
Thumbnail do vídeo: Todas as APIs do Google em um Só Lugar

YouTube, Gmail, Drive, Planilhas, Analytics e Search Console podem entrar em automações, mas cada serviço exige que você configure o acesso à conta Google. Eu montei um conector OAuth para centralizar essa autorização e deixar as contas disponíveis aos meus scripts e à IA, sem repetir o mesmo processo em cada automação.

Centralize a autorização das contas Google

Quando configurei o Google Cloud, encontrei mais de 531 APIs na lista. O número muda com o tempo, mas dá uma ideia da quantidade de serviços disponíveis: dá para publicar no YouTube, consultar o Analytics, ler dados do Search Console e integrar outras ferramentas do Google. A dificuldade aparece quando cada script exige que você organize projetos, contas e autorizações de novo.

Foi por isso que criei o Google Connector. Eu conecto uma conta, identifico ela no painel e deixo a autorização disponível para mais de uma automação minha. Assim, não preciso refazer o fluxo de consentimento para cada script. O conector não ativa todas as APIs automaticamente nem substitui a configuração do Google Cloud: ele organiza o acesso OAuth às APIs que você habilitou.

Escolha as permissões antes de conectar cada conta

No painel, você escolhe os escopos que o conector vai pedir e dá um nome à conta para reconhecê-la depois, como “principal” ou “canal”. Aí inicia a conexão com o Google e aprova os acessos necessários. Também pode adicionar outras contas, cada uma identificada separadamente, para a automação usar a conta certa.

Um escopo define o que o programa pode fazer em nome da conta. Você pode autorizar uma consulta de leitura ao Analytics ou permitir que a automação publique no YouTube. No Gmail, leitura de mensagens e exclusão são permissões bem diferentes. Eu não marcaria tudo só para simplificar: escolha os acessos da tarefa que quer executar e confira a tela do Google antes de consentir. A documentação do Google lista os escopos de cada API e explica quando um acesso é sensível ou restrito.

Quando o app está em desenvolvimento, o Google pode mostrar o aviso de aplicativo não verificado. Para testar com uma conta sua, é possível avançar pelo aviso, como fiz. Esse caminho não libera o app para qualquer pessoa: projetos de teste têm limites, e um aplicativo público que pede escopos sensíveis ou restritos pode precisar ser verificado pelo Google. Eu trataria a tela de teste como parte do desenvolvimento, não como uma etapa para orientar os usuários de um produto lançado.

Instale uma cópia na sua própria Cloudflare

Deixei o projeto no GitHub como ponto de partida. Ele reúne um Worker com o painel e o fluxo OAuth, um banco D1 para as contas e os tokens criptografados e instruções para a instalação. Cada pessoa publica a própria cópia na Cloudflare; não é um serviço público em que todo mundo entrega os dados da conta Google para mim.

Você pode baixar o repositório, abrir a pasta numa IA de programação e pedir ajuda para configurar o projeto e fazer o deploy com as suas credenciais. Mas ainda precisa criar ou configurar o projeto OAuth no Google Cloud, habilitar as APIs que vai usar, informar o endereço de retorno do seu Worker e fornecer os dados necessários à instalação. O Client ID e os segredos são seus; o repositório vem com campos de configuração, não com as minhas credenciais.

No meu teste, a IA aproveitou uma autenticação da Cloudflare que já estava configurada no ambiente e publicou o Worker. Para instalar na sua conta, revise o que a IA vai executar e coloque os segredos nos campos de segredo do Worker ou no ambiente local, sem gravá-los em arquivos que serão enviados ao GitHub. Se quiser hospedar em outro provedor, também dá, mas será preciso adaptar o Worker, o banco e a configuração de segredos.

Use a conta autorizada em tarefas reais

Com a conta conectada, uma das automações que montei envia um vídeo ao YouTube e prepara os dados da publicação: títulos e descrições em vários idiomas, tags, capítulos, miniatura e legendas em SRT. O fluxo de postagem usa os acessos que autorizei; não precisa pedir que eu refaça a conexão toda vez que executo outro trabalho.

Também pedi à IA para consultar o Analytics, localizar páginas que estavam retornando 404 e comparar esses endereços com as páginas atuais do site. Isso ajuda a encontrar links internos quebrados usando dados que já estavam na conta, sem abrir os painéis um por um. Search Console e Custom Search podem entrar no mesmo tipo de fluxo se você habilitar as APIs e conceder os escopos correspondentes.

A ideia que eu adaptei de uma integração que já usava para publicar no Instagram foi ter um autenticador central, hospedado por mim, para conversar com vários serviços do Google. Comece habilitando as APIs e permissões de uma tarefa concreta, conecte a conta correta e teste a automação. Depois acrescente outros escopos conforme precisar. Assim você aproveita o mesmo conector sem entregar acesso desnecessário à conta.

O conector também combina com um fluxo de publicação de vídeos no YouTube com IA.