Tópico dedicado ao setup e uso do **GWS CLI (Google Workspace CLI)**,…
INEMA
Resumo curto do processo de setup do GWS CLI
O setup do GWS CLI foi concluído em 9 etapas, envolvendo autenticação no Google Cloud, criação de credenciais OAuth e verificação do acesso ao Google Drive.
Principais pontos do processo⌗
-
Autenticação inicial:
gcloud auth loginfalhou no terminal não-interativo, então foi feito via Firefox real usando--launch-browser, com login manual. -
Configuração do projeto:
gws auth setupidentificou corretamente o projeto inema-tds-459114, aguardando apenas as credenciais OAuth. -
Configuração OAuth no Google Cloud: O Google bloqueou automação via Playwright, então foi usada automação com Selenium + Firefox (Marionette) para configurar:
-
OAuth Consent Screen (External)
- Aplicação “gws CLI”
-
Conta de suporte
inematds@gmail.com -
Criação do OAuth Client ID: A nova interface do Google Auth Platform exigiu adaptação na navegação automatizada. O client final criado foi Desktop app “gws CLI final”.
-
Captura do Client Secret (maior desafio): A nova UI mascara o secret. A solução foi interceptar a resposta da API interna via JavaScript (XHR interception) no navegador, capturando o secret antes de ser ocultado.
-
Configuração local: Criado o arquivo:
~/.config/gws/client_secret.json
- Autenticação OAuth do GWS: Selenium automatizou o consentimento do usuário e salvou os tokens em:
~/.config/gws/credentials.enc
- Verificação final:
gws drive files listretornou arquivos do Google Drive, confirmando que o setup está funcionando end-to-end.
Principais lições⌗
- Google bloqueia Playwright/Chromium automatizado para login.
- Firefox real + Selenium/Marionette funciona melhor para automação com Google.
- A nova UI do Google oculta o client secret, sendo necessário interceptar a resposta da API.
- Automatizar um navegador já logado (
--connect-existing) evita problemas de sessão.
✔ Resultado final: GWS CLI autenticado e acessando o Google Drive com sucesso.
temos 3 tipos de arquivo, eu prefiro o markdown , avaliam e escolham o q mais vc se adapta
use o arquivo anexo para executar q esta mais Claro
PROMPT DE CONFIGURAÇÃO GWS⌗
Instalação completa — cole no Claude Code
Copie todo o bloco de código abaixo e cole no Claude Code como sua tarefa. Antes de executar, substitua [*YOUR_EMAIL@DOMAIN.COM*] (destacado em laranja) pelo seu email real da conta Google nos dois lugares em que aparece.
Antes de executar este prompt, leia as notas abaixo:
1. “Do not pause for confirmations”⌗
Essa linha instrui o Claude a agir autonomamente sem parar para pedir confirmações.
Funciona bem para configurações pessoais.
Se você estiver executando isso em:
- um ambiente empresarial
- um projeto GCP compartilhado
- qualquer infraestrutura sensível
é recomendado remover ou modificar essa linha antes de executar.
Você pode preferir que o Claude confirme cada etapa com você.
2. Este prompt executa ações reais⌗
Ele irá:
- autenticar sua conta Google Cloud
- criar credenciais OAuth no seu projeto GCP
- escrever arquivos na sua máquina
Revise os passos e tenha certeza de que está confortável com cada um deles.
Tarefa⌗
Configurar o Google Workspace CLI (gws) do início ao fim
Execute a configuração completa usando:
- Bash para etapas no terminal
- Claude com automação do navegador Chrome para etapas na web
Não pause para confirmações. Pare apenas se algo realmente bloquear o progresso.
Objetivo⌗
Autenticar o Google Cloud, criar credenciais OAuth, configurar a autenticação do gws e verificar o acesso ao Google Drive.
Passos⌗
1. Autenticar o Google Cloud⌗
Execute:
gcloud auth login
Certifique-se de que novas credenciais sejam obtidas.
2. Inicializar autenticação do gws⌗
Execute:
gws auth setup
Isso pode falhar devido à ausência de um cliente OAuth — isso é esperado.
Capture o projeto GCP ativo exibido na saída.
3. Abrir credenciais no Google Cloud Console⌗
Abra o Chrome e navegue até a página de Credenciais do Google Cloud Console para o projeto ativo.
Use o projeto identificado no Passo 2.
IMPORTANTE: Use o seletor de conta no canto superior direito do Google Cloud Console e verifique se a conta ativa é:
[YOUR_EMAIL@DOMAIN.COM]
4. Configurar a tela de consentimento OAuth⌗
(se ainda não estiver configurada)
Se solicitado, defina:
User Type:
External
App Name:
gws CLI
Support Email:
[YOUR_EMAIL@DOMAIN.COM]
Prossiga por todas as etapas e salve.
5. Criar OAuth Client ID⌗
Vá em:
Create Credentials > OAuth client ID
Defina:
Application Type:
Desktop app
Name:
gws CLI
Clique em Create.
6. Capturar credenciais⌗
Quando a janela aparecer:
Copie:
- Client ID
- Client Secret
7. Criar arquivo de credenciais local⌗
Execute:
mkdir -p ~/.config/gws
Crie o arquivo:
~/.config/gws/client_secret.json
Escreva as credenciais no formato padrão JSON de client_secret do OAuth do Google.
8. Completar fluxo OAuth⌗
Execute:
gws auth login
Isso abrirá um navegador para finalizar a autenticação.
9. Verificar instalação⌗
Execute:
gws drive files list --params '{"pageSize": 5}'
Se funcionar, significa que a configuração foi concluída com sucesso.
Notas⌗
- Se a identidade da conta não estiver clara, use o alternador de contas do Google Cloud Console (canto superior direito).
- Não peça confirmações — proceda automaticamente.
- Pare apenas se ocorrer um bloqueio real.
O que é [YOUR_EMAIL@DOMAIN.COM]?⌗
É a conta Google usada para acessar o Google Cloud Console:
console.cloud.google.com
Essa conta deve ser Owner ou Editor do projeto GCP que você quer conectar ao gws.
GWS (Google Workspace CLI) é uma ferramenta do Google que permite controlar e automatizar serviços do Google Workspace pela linha de comando.
O que ele faz⌗
Permite que você ou uma IA execute ações diretamente em serviços como:
- Gmail
- Google Calendar
- Google Drive
- Google Docs
- Google Sheets
- Google Slides
Tudo através de comandos ou linguagem natural usando IA.
Exemplo:
- ler emails
- criar planilhas
- analisar reuniões
- organizar arquivos do Drive
- gerar relatórios automaticamente.
Vantagem principal⌗
A grande vantagem é automatizar tarefas do Google diretamente, sem precisar de ferramentas intermediárias.
Benefícios⌗
- ⚡ Automação completa do Google Workspace
- 🤖 Integração com IA (Claude, agentes, etc.)
- 💰 Sem custo de ferramentas como Zapier ou Make
- 🔗 Pode combinar vários serviços em um único comando
- 🧠 Permite criar assistentes pessoais automatizados
✅ Resumo em uma frase: O GWS CLI é uma ferramenta que permite usar IA ou comandos para automatizar e controlar todo o Google Workspace de forma direta e poderosa.
assistente pessoal * automação de emails * preparação de reuniões * organização de arquivos * relatórios automáticos
Pode até rodar via bot no Telegram.
Conclusão⌗
O Google Workspace CLI permite criar agentes de IA extremamente poderosos que interagem diretamente com sua conta Google.
Principais vantagens:
- automação completa
- integração total com Google
- sem ferramentas intermediárias
- execução via linguagem natural
- possibilidade de criar workflows complexos
Resultado: um “assistente executivo de IA” rodando dentro do seu Google Workspace.
Resumo do vídeo⌗
“Claude Code + Google's New CLI = GOD MODE”
1. O que é o Google Workspace CLI⌗
- O Google Workspace CLI (GWS CLI) é uma ferramenta oficial do Google.
- Permite acessar serviços do Google via linha de comando.
-
Dá acesso direto a:
-
Gmail
- Google Calendar
- Google Drive
- Google Docs
- Google Sheets
- Google Slides
- Pode ser usado por agentes de IA para executar tarefas automaticamente.
Benefício principal: Permite automação completa do Google Workspace sem precisar de ferramentas intermediárias como:
- Zapier
- Make.com
2. O que é CLI (Command Line Interface)⌗
CLI = Interface de linha de comando.
Diferença:
| Termo | Explicação |
|---|---|
| Terminal | Interface básica do sistema |
| CLI | Terminal com comandos específicos de um serviço |
Exemplo de comando:
gws gmail messages list
Estrutura do comando:
- ferramenta →
gws - serviço →
gmail - recurso →
messages - ação →
list - parâmetros opcionais
Antes era preciso decorar esses comandos, mas com IA você só usa linguagem natural.
Fluxo moderno:
Você descreve a tarefa
↓
Claude Code escreve o comando
↓
CLI executa
3. Estrutura do projeto no GitHub⌗
O repositório possui:
Skills⌗
- Fluxos automáticos reutilizáveis
- Exemplo: organizar emails
Recipes⌗
- SOPs (procedimentos)
- Combinação de várias skills e comandos
O CLI possui 101 funcionalidades prontas.
4. Diferença entre CLI, Skills e MCP⌗
CLI⌗
- Mais poderoso
- Ideal para tarefas únicas
Skills⌗
- Usar quando você repete tarefas
- Transformar o fluxo em automação
MCP⌗
- Mais complexo
- Usar apenas se necessário
Ordem recomendada:
1️⃣ CLI
2️⃣ Skills
3️⃣ MCP
5. Como instalar o Google Workspace CLI⌗
Comando:
npm install -g @googleworkspace/cli
Depois é necessário configurar autenticação no Google Cloud.
Passos principais:
- Criar projeto no Google Cloud
- Ir em APIs & Services
- Criar credenciais
- Criar OAuth Desktop App
- Baixar arquivo JSON
- Usar no CLI
6. Automação da instalação com IA⌗
O autor usa um “mega prompt” para o Claude Code:
O prompt faz o Claude:
- abrir navegador
- acessar Google Cloud
- criar credenciais
- configurar OAuth
- baixar JSON
- finalizar setup
Tudo automaticamente.
7. Exemplos práticos de uso⌗
Exemplo 1 — Priorizar emails⌗
Prompt:
- ler últimos 20 emails
-
extrair:
-
assunto
- remetente
- trecho da mensagem
- classificar por prioridade
- criar Google Sheet automático
Resultado:
- planilha organizada
- prioridade por cores
Exemplo 2 — Relatório semanal automático⌗
Prompt faz:
- pegar eventos do Google Calendar
- contar:
- reuniões
- horas em reunião
- pessoas mais encontradas 3. analisar últimos 30 emails 4. criar Google Slides com relatório
Exemplo 3 — Encontrar emails importantes⌗
Busca emails contendo:
- proposal
- quote
- invoice
- contract
Depois:
- verifica se você respondeu
- se não respondeu há 5 dias
- cria email de follow-up automaticamente
Exemplo 4 — Brief automático de reunião⌗
Fluxo:
- encontra próximo evento no calendário
- identifica participantes
- busca emails recentes com eles
- cria Google Doc com briefing
Conteúdo gerado:
- contexto
- histórico de emails
- agenda sugerida
Exemplo 5 — Auditoria do Google Drive⌗
Prompt:
Buscar arquivos com nomes como:
- draft
- old
- backup
- v1, v2, v3
- final_final
Depois criar planilha com:
- nome do arquivo
- tipo
- data de modificação
- tamanho
- link compartilhável
Serve para organizar drives bagunçados.
8. Grande vantagem do sistema⌗
Você pode combinar vários serviços do Google em um único prompt.
Exemplo:
Gmail + Calendar + Docs + Sheets + Slides
Tudo executado automaticamente.
9. Aplicação prática com agentes de IA⌗
O autor usa isso para criar:
*
Observe que gravou as autenticações no arquivo ~.config\gws\client_secret.json
GWS CLI - Google Workspace
1