cerebro-vip INEMA.CLUB
inícioINEMA.DEV Desenvolvimento

Tópico dedicado ao setup e uso do **GWS CLI (Google Workspace CLI)**,…

INEMA.DEV Desenvolvimento · 2026-03-10 · ~8 min · ver no Telegram ↗

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 login falhou no terminal não-interativo, então foi feito via Firefox real usando --launch-browser, com login manual.

  • Configuração do projeto: gws auth setup identificou 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 list retornou 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:

  1. ferramenta → gws
  2. serviço → gmail
  3. recurso → messages
  4. ação → list
  5. 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:

  1. Criar projeto no Google Cloud
  2. Ir em APIs & Services
  3. Criar credenciais
  4. Criar OAuth Desktop App
  5. Baixar arquivo JSON
  6. 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:

  1. pegar eventos do Google Calendar
  2. 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:

  1. encontra próximo evento no calendário
  2. identifica participantes
  3. busca emails recentes com eles
  4. 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:

*

youtu.be/WB32ZobHIuI ↗

Observe que gravou as autenticações no arquivo ~.config\gws\client_secret.json

GWS CLI - Google Workspace

chatgpt.com ↗

1

Recursos

↑ voltar ao topo · ver no Telegram ↗