Tópico dedicado ao Google Workspace CLI (GWS), cobrindo instalação,…

INEMA

Para automatizar a autenticação com a Google Workspace CLI (ou qualquer ferramenta que use APIs do Google), existem 3 métodos principais. Cada um serve para um cenário diferente. Vou explicar do mais simples ao mais profissional.

1️⃣ Usar OAuth uma vez e reutilizar o refresh token (mais comum)⌗

Esse é o método mais usado quando você quer agir como um usuário normal.

Como funciona⌗

Você faz login uma única vez.
O sistema salva:

access_token
refresh_token 3. O programa usa o refresh token para gerar novos access tokens automaticamente.

Fluxo⌗

Usuário faz login → recebe refresh token → CLI renova token automaticamente

Exemplo simplificado⌗

gws auth login

Depois o token fica salvo em algo como:

~/.config/google-workspace-cli/

Nos próximos comandos a CLI reutiliza esse token.

Vantagens⌗

✔ simples ✔ funciona com conta gratuita ✔ não precisa logar sempre

Problema comum⌗

Você precisa logar novamente se:

o refresh token for revogado
o projeto OAuth estiver em modo testing
a política de sessão expirar

2️⃣ Service Account (automatização real)⌗

Esse é o método usado em scripts, servidores e CI/CD.

Como funciona⌗

Você cria uma conta de serviço no Google Cloud e usa uma chave JSON.

Fluxo:

script → service account → API Google

Criar service account⌗

Acesse:

https://console.cloud.google.com

Vá em

IAM & Admin → Service Accounts

Crie uma conta.
Baixe a chave JSON.

Usar no script⌗

export GOOGLE_APPLICATION_CREDENTIALS="service-account.json"

Ou diretamente:

gws auth activate-service-account --key-file service-account.json

Vantagens⌗

✔ não precisa login
✔ funciona em servidores
✔ ideal para automação

Limitação importante⌗

Service account não acessa dados do usuário diretamente.

Para isso você precisa de:

Domain Wide Delegation

Isso só existe em Google Workspace pago.

3️⃣ OAuth com usuário de teste automatizado⌗

Se você estiver desenvolvendo uma aplicação, pode usar usuários de teste.

Configuração⌗

No console OAuth:

Google Cloud Console APIs & Services OAuth Consent Screen Test Users

Adicione os emails.

Exemplo:

test@gmail.com nei.maldaner@gmail.com

Limitação⌗

No modo Testing:

refresh tokens podem expirar em 7 dias
login pode ser exigido novamente

Por isso você está vendo a autenticação semanal.

🔎 Como evitar logar toda semana⌗

Opções:

1️⃣ Colocar o app em produção⌗

No OAuth Consent Screen:

Publishing Status → Production

Isso remove a expiração de 7 dias.

2️⃣ Usar service account⌗

Melhor para automação.

3️⃣ Salvar e reutilizar refresh token⌗

Seu script pode usar:

refresh_token client_id client_secret

para gerar access tokens.

💡 Arquitetura recomendada para automação⌗

Se você quiser algo estável, use:

Script ↓ Service Account ↓ Google API

Se precisa agir como usuário:

Service Account ↓ Domain Delegation ↓ Usuário Workspace

Vou separar a resposta em três partes: (1) contas gratuitas, (2) contas pagas/Workspace, e (3) autenticação e por que você precisa logar novamente.

1. Uso com conta gratuita (Google pessoal)⌗

Com uma conta Google comum (Gmail) você pode usar a CLI normalmente, porque ela apenas acessa as APIs públicas do Google Workspace (Drive, Gmail, Calendar etc.). Não há um “plano pago obrigatório” para usar a CLI.

O que é possível com conta gratuita⌗

Acesso às APIs do Google Workspace (Drive, Gmail, Calendar, Docs, Sheets etc.).
Automação de tarefas (scripts, bots, integrações).
Autenticação OAuth padrão via navegador. ([GIGAZINE][1])

Limitações principais⌗

As limitações não vêm da CLI em si, mas das APIs do Google:

Cotas de API

Cada API tem limite de requisições por minuto/dia.
Se ultrapassar, a API retorna erro até a cota reiniciar. ([developers.google.com][2])

Sem recursos administrativos

Contas pessoais não podem usar APIs de administração do Workspace (ex.: gerenciar usuários de domínio).

Sem delegação de domínio

Apenas contas Workspace podem usar domain-wide delegation (impersonar usuários via service account). ([dev.to][3])

Limite de refresh tokens

Máximo 50 refresh tokens por conta e cliente OAuth.
Criar novos pode invalidar os antigos. ([stackoverflow.com][4])

2. Conta paga (Google Workspace / organização)⌗

Quando você usa Google Workspace (empresa ou instituição):

Vantagens⌗

APIs administrativas

Admin SDK
gerenciamento de usuários
grupos
segurança

Automação corporativa

Domain-wide delegation
service accounts
integração com sistemas internos.

Controle de segurança

políticas de sessão
autenticação reforçada
auditoria.

Maior controle de cotas

administradores podem solicitar aumento de limites de API. ([Google for Developers][2])

3. Autenticação e por que você precisa logar novamente⌗

Esse comportamento é normal.

Como funciona a autenticação⌗

O fluxo é padrão OAuth 2.0:

CLI abre o navegador.
Você autoriza o acesso.
O sistema salva:

access token (curto prazo)
refresh token (renova o access token).

Por que você precisa autenticar novamente⌗

Existem vários motivos possíveis.

1️⃣ Expiração da sessão⌗

Administradores podem definir tempo máximo de sessão (ex.: 7 dias). Quando expira, é preciso logar novamente. ([docs.cloud.google.com][5])

2️⃣ Política de segurança⌗

Algumas ações exigem reauthentication obrigatória.

3️⃣ Refresh token expirado ou invalidado⌗

Pode acontecer se:

novas autorizações foram criadas
limite de tokens foi atingido.

4️⃣ Modo “testing” no OAuth⌗

Se o projeto está em modo de teste, o token costuma expirar com mais frequência.

4. Métodos de autenticação disponíveis⌗

A CLI geralmente suporta:

1️⃣ Login interativo (OAuth)

gws auth login

2️⃣ Service account

ideal para servidores e CI/CD

3️⃣ Access token existente

usado em pipelines ou agentes. ([GIGAZINE][1])

5. Resumo simples⌗

Tipo de conta	Pode usar CLI?	Limites principais	Vantagens
Google gratuito	✔	cotas de API, sem admin	simples de usar
Workspace pago	✔	políticas de segurança	admin APIs, automação corporativa
Service account	✔	requer configuração	ideal para servidores

✅ Sobre seu teste: Se você precisa autenticar toda semana, provavelmente é:

política de sessão do Google
OAuth em modo de teste
refresh token expirando.

youtu.be/TiXFIL58o3Q ↗

Chrome DevTools = ferramentas internas do navegador usadas para analisar e controlar páginas web.

Contas pessoais gratuitas do Google (Gmail, Documentos, Planilhas, Agenda, Apresentações) ainda funcionam sem um plano pago do Workspace.

Preços do Google Workspace (2026) (O produto atual chamado Google Workspace)

Cobrança anual (por usuário/mês): Investimento inicial: US$ 7,00 Padrão comercial: US$ 14,00 Business Plus: US$ 22,00 Empresa: Personalizado

Cobrança mensal (por usuário/mês): Investimento inicial em negócios: US$ 8,40 Padrão comercial: US$ 16,80 Business Plus: US$ 26,40

Observação: Os preços refletem o aumento de janeiro de 2025 (17-22% em todos os planos). O pagamento anual proporciona uma economia de aproximadamente 20%. Todos os planos incluem um período de teste gratuito de 14 dias.

Ativar as APIS

Mostra o momento em que ele termina a configuração manual (Option B) e está tentando fazer o login no GWS CLI usando o arquivo de credenciais.

Vou explicar o que está acontecendo na tela.

1️⃣ Ele diz que terminou a configuração manual⌗

Ele escreve algo como:

“I finished option B, the credentials are called client_secret.json, run gws auth login”

Ou seja:

ele já criou o projeto no Google Cloud
já criou as credenciais OAuth
já baixou o arquivo client_secret.json

Agora falta autenticar o CLI com a conta Google.

O comando que ele precisa rodar é:

gws auth login

Esse comando abre o navegador para autorizar acesso à conta Google.

2️⃣ O sistema tenta encontrar o arquivo de credenciais⌗

Antes de fazer login, o sistema tenta localizar o arquivo client_secret.json no computador.

Ele roda um comando parecido com:

ls ~/client_secret.json ls ~/Downloads/client_secret.json

Resultado:

not found in common locations

Ou seja:

👉 o arquivo não estava nas pastas comuns.

3️⃣ Ele então faz uma busca completa⌗

Depois ele roda um comando de busca:

find /c/Users/nateh -maxdepth 3 -name "client_secret*.json"

Esse comando procura o arquivo no computador inteiro.

Resultado encontrado:

/c/Users/nateh/.config/gws/client_secret.json

/c/Users/nateh/OneDrive/Documents/client_secret_XXXXX.json

Ou seja:

✔ o arquivo foi encontrado.

4️⃣ Por que isso é necessário⌗

O GWS CLI precisa desse arquivo porque ele contém:

client ID
client secret
configuração OAuth

Essas informações permitem que o CLI:

abra a tela de login Google
peça autorização para acessar Drive, Gmail, Docs etc.

Resumo do que aconteceu na tela⌗

Ele terminou a configuração manual
criou o arquivo client_secret.json
o sistema tentou localizar o arquivo
encontrou o arquivo
agora pode rodar:

gws auth login

para conectar o CLI ao Google Workspace.

💡 Uma curiosidade interessante do vídeo: O Claude Code estava rodando comandos no terminal sozinho para encontrar o arquivo. Isso mostra como o agente consegue usar o sistema operacional para resolver problemas automaticamente.

a parte A ele Instala muita coisa, é mais para Grandes Emnpresa, melhor a B q parece mais Complexa mas é mais simples.

Duas formas de configurar o GWS CLI: automática com gcloud ou manual sem ele. Melhor a opção B

Opção A — Usando gcloud (configuração automática)⌗

Essa é a forma recomendada, porque o próprio comando do GWS faz quase tudo sozinho.

Passos⌗

Baixar o Google Cloud CLI (gcloud) Link: https://cloud.google.com/sdk/docs/install
Instalar no computador

No Windows é só executar o instalador.

Rodar o comando:

gws auth setup

Esse comando faz automaticamente:

cria o projeto no Google Cloud
ativa as APIs necessárias
configura o OAuth
conecta sua conta Google

Ou seja, ele automatiza quase toda a configuração.

Opção B — Configuração manual (sem gcloud)⌗

Aqui você faz tudo manualmente no Google Cloud Console.

Passos⌗

Ir para console.cloud.google.com
Criar um projeto no Google Cloud
Ativar as APIs do Workspace:

Google Drive API
Gmail API
Calendar API
Sheets API
Docs API
Slides API

Criar a OAuth Consent Screen

adicionar seu email como test user

Criar credenciais OAuth

tipo Desktop App

Baixar o arquivo JSON de credenciais
Salvar o arquivo em:

~/.config/gws/client_secret.json

Rodar o login:

gws auth login

Isso abre o navegador para você autorizar acesso à sua conta Google.

Diferença entre as duas opções⌗

Método	Vantagem	Desvantagem
gcloud	configuração automática	precisa instalar o SDK
manual	não precisa instalar gcloud	mais passos

💡 Resumo simples

Com gcloud: tudo quase automático
Sem gcloud: você configura cada parte manualmente.

Quando você instala o GWS CLI, existem duas formas de configurar a autenticação com o Google:

1️⃣ Opção mais fácil: usando o gcloud CLI⌗

Você pode instalar o Google Cloud CLI (gcloud) e usar ele para configurar tudo automaticamente.

Com o gcloud instalado, o processo fica mais simples porque ele:

cria e gerencia o projeto no Google Cloud
configura a autenticação
conecta sua conta Google
facilita o acesso às APIs do Workspace

Ou seja, ele automatiza boa parte da configuração.

2️⃣ Opção manual⌗

Como o gcloud não funcionou tão direto o caminho manual, que envolve:

Criar um projeto no Google Cloud Console
Configurar a OAuth consent screen
Criar um OAuth Client ID
Baixar o arquivo de credenciais JSON
Colocar esse arquivo na pasta do GWS
Rodar o login com:

gws auth login

Depois disso precisou ativar as APIs do Google Workspace (Drive, Docs, Gmail, etc).

💡 Ideia principal⌗

O gcloud serve para simplificar a configuração do GWS CLI.

Sem ele:

você faz tudo manualmente no console do Google.

Com ele:

várias etapas podem ser automatizadas.

Vou explicar um exemplo simples de como o GWS CLI pode ser usado na prática.

Imagine que eu tenho um vídeo do YouTube e quero transformar aquele conteúdo em um material organizado dentro do Google Docs.

Primeiro, eu simplesmente pego o link do vídeo e envio para a IA que está conectada ao GWS CLI. A partir disso, o sistema consegue baixar automaticamente o transcript do vídeo e entender o conteúdo que foi falado.

Depois disso, em vez de criar um documento usando API tradicional (que geralmente gera um texto cru), o GWS CLI executa comandos diretamente no Google Workspace para criar o documento.

Com isso, ele cria um Google Doc automaticamente e já começa a preencher o conteúdo.

O interessante é que o documento já sai todo estruturado, por exemplo:

título do material
imagem ou capa no topo
links importantes
seções organizadas com subtítulos
resumo do conteúdo
e até uma chamada para ação no final

Ou seja, quando eu abro o documento no Google Docs, ele já está pronto e bem formatado, não é só um monte de texto jogado.

Isso resolve um problema comum quando usamos IA com documentos: normalmente o resultado sai como markdown ou texto bruto, que depois precisa ser ajustado manualmente.

Com o GWS CLI, o processo muda completamente, porque a IA cria e edita o documento diretamente dentro do Google Docs, deixando tudo organizado automaticamente.

Na prática, o fluxo funciona mais ou menos assim:

CLI → cria o documento → analisa o conteúdo → preenche e formata o material automaticamente.

Isso mostra como o GWS CLI pode transformar tarefas que levariam vários minutos ou horas em um processo quase automático dentro do Google Workspace.

“Não é oficialmente suportado pelo Google” por causa do status do projeto, não porque seja falso ou inseguro.

1. É open-source experimental⌗

O GWS CLI é um projeto:

open-source
em desenvolvimento ativo
ainda não virou produto oficial corporativo

Ou seja, está mais como um projeto de desenvolvedores do Google ou da comunidade.

2. Ainda não chegou na versão 1.0⌗

No repositório ele menciona:

“Expect breaking changes”
ainda em evolução

Isso significa que:

comandos podem mudar
APIs podem mudar
algumas coisas podem quebrar.

Empresas grandes só consideram “oficial” quando o produto está estável.

3. Não tem suporte corporativo⌗

Produtos oficiais do Google normalmente têm:

suporte técnico
SLA
documentação estável
garantia de manutenção

Esse projeto não tem suporte empresarial ainda.

4. Mas ele usa APIs reais do Google⌗

Mesmo não sendo oficialmente suportado:

usa Google Workspace APIs oficiais
autenticação OAuth do Google
integração com Google Cloud

Ou seja: 👉 é legítimo, só não é um produto comercial oficial ainda.

5. Por que o Google faz isso⌗

Empresas grandes costumam lançar ferramentas assim para:

testar ideias com desenvolvedores
receber feedback
evoluir antes de virar produto oficial.

💡 Curiosidade: Se essa ferramenta ganhar adoção, é bem provável que o Google transforme isso em algo tipo “Google Workspace Agent Toolkit”, porque ela praticamente cria um agente de IA para todo o Workspace.

github.com/googleworkspace/cli ↗

1. Lançamento do Google Workspace CLI (GWS)⌗

Google lançou uma ferramenta de linha de comando (CLI) para acessar o Google Workspace.
Permite controlar Drive, Gmail, Calendar, Docs, Sheets, Slides e Admin via comandos.
Pode ser usado por agentes de IA como Claude Code para automatizar tarefas.

2. O que o GWS CLI consegue fazer⌗

Comandos permitem:

Buscar, listar, enviar, baixar, mover e compartilhar arquivos no Google Drive.
Gerenciar emails no Gmail.
Criar e editar Docs, Sheets e Slides.
Agendar eventos no Google Calendar.

3. Workflows prontos (“skills”)⌗

A ferramenta inclui mais de 100 automações pré-definidas.
Exemplos:
Criar documentos a partir de templates
Gerar relatórios a partir de planilhas
Encontrar horários livres e marcar reuniões
Organizar e arquivar emails
Criar apresentações

4. Integração com IA (Claude Code)⌗

IA pode executar comandos do Workspace diretamente no terminal.
Exemplo mostrado:
Inserir um link de vídeo do YouTube
A IA baixa o transcript
Cria automaticamente um Google Doc formatado com resumo e links

5. Vantagens da ferramenta⌗

Interface única para todo o Google Workspace.
Respostas estruturadas em JSON (facilita uso por IA).
Auto-descoberta de APIs (atualiza automaticamente).
Baixa manutenção após autenticação.
Alternativa mais simples do que usar várias APIs ou MCPs.

6. O que é CLI⌗

CLI = Command Line Interface (interface por comandos de texto).
Diferente da GUI (botões e menus).
Computadores e agentes de IA trabalham melhor com comandos textuais.

7. Instalação (resumo)⌗

Passos básicos:

Baixar o projeto no GitHub.
Instalar o GWS CLI.
Criar um projeto no Google Cloud.
Configurar OAuth credentials.
Fazer login com gws auth login.
Ativar APIs do Workspace.

8. Exemplos de automação mostrados⌗

Priorizar emails automaticamente.
Criar apresentações no Google Slides.
Gerar relatórios a partir de dados.
Construir automações tipo assistente executivo pessoal.

9. Limitações atuais⌗

Projeto open-source e ainda em beta.
Não é oficialmente suportado pelo Google ainda.
Pode ter:
reautenticações
bugs
mudanças na API

10. Conclusão⌗

Ferramenta considerada extremamente poderosa para automação com IA.
Ideal para quem usa IA como assistente para trabalho ou produtividade.
Deve melhorar muito até a versão 1.0.

Google Workspace CLI (GWS)

chatgpt.com ↗

Tópico dedicado ao Google Workspace CLI (GWS), cobrindo instalação,…

1️⃣ Usar OAuth uma vez e reutilizar o refresh token (mais comum)⌗

Como funciona⌗

Fluxo⌗

Exemplo simplificado⌗

Vantagens⌗

Problema comum⌗

2️⃣ Service Account (automatização real)⌗

Como funciona⌗

Criar service account⌗

Usar no script⌗

Vantagens⌗

Limitação importante⌗

3️⃣ OAuth com usuário de teste automatizado⌗

Configuração⌗

Limitação⌗

🔎 Como evitar logar toda semana⌗

1️⃣ Colocar o app em produção⌗

2️⃣ Usar service account⌗

3️⃣ Salvar e reutilizar refresh token⌗

💡 Arquitetura recomendada para automação⌗

1. Uso com conta gratuita (Google pessoal)⌗

O que é possível com conta gratuita⌗

Limitações principais⌗

2. Conta paga (Google Workspace / organização)⌗

Vantagens⌗

3. Autenticação e por que você precisa logar novamente⌗

Como funciona a autenticação⌗

Por que você precisa autenticar novamente⌗

1️⃣ Expiração da sessão⌗

2️⃣ Política de segurança⌗

3️⃣ Refresh token expirado ou invalidado⌗

4️⃣ Modo “testing” no OAuth⌗

4. Métodos de autenticação disponíveis⌗

5. Resumo simples⌗

1️⃣ Ele diz que terminou a configuração manual⌗

2️⃣ O sistema tenta encontrar o arquivo de credenciais⌗

3️⃣ Ele então faz uma busca completa⌗

4️⃣ Por que isso é necessário⌗

Resumo do que aconteceu na tela⌗

Opção A — Usando gcloud (configuração automática)⌗

Passos⌗

Opção B — Configuração manual (sem gcloud)⌗

Passos⌗

Diferença entre as duas opções⌗

1️⃣ Opção mais fácil: usando o gcloud CLI⌗

2️⃣ Opção manual⌗

💡 Ideia principal⌗

1. É open-source experimental⌗

2. Ainda não chegou na versão 1.0⌗

3. Não tem suporte corporativo⌗

4. Mas ele usa APIs reais do Google⌗

5. Por que o Google faz isso⌗

1. Lançamento do Google Workspace CLI (GWS)⌗

2. O que o GWS CLI consegue fazer⌗

3. Workflows prontos (“skills”)⌗

4. Integração com IA (Claude Code)⌗

5. Vantagens da ferramenta⌗

6. O que é CLI⌗

7. Instalação (resumo)⌗

8. Exemplos de automação mostrados⌗

9. Limitações atuais⌗

10. Conclusão⌗

Recursos