Skip to content

SETUP_GUIDE.md

Latest commit

 

History

History
53 lines (38 loc) · 2.24 KB

SETUP_GUIDE.md

File metadata and controls

53 lines (38 loc) · 2.24 KB

Guia de Configuração: Google Cloud & OAuth 🔐

Este guia descreve passo-a-passo como configurar um projeto no Google Cloud Platform (GCP) para habilitar a API do Gmail e obter as credenciais necessárias para o gmail-cli.

1. Criar um Projeto no GCP

  1. Acesse o Google Cloud Console.
  2. Clique no seletor de projetos (canto superior esquerdo) e selecione "Novo Projeto".
  3. Dê um nome ao projeto (ex: gmail-cli-user) e clique em "Criar".

2. Habilitar a API do Gmail

  1. No menu lateral, vá para "APIs e Serviços" > "Biblioteca".
  2. Na barra de busca, digite Gmail API.
  3. Selecione o resultado e clique em "Ativar".

3. Configurar a Tela de Consentimento OAuth

  1. Vá para "APIs e Serviços" > "Tela de permissão OAuth".
  2. Selecione "Externo" (para uso pessoal, é o mais simples) e clique em "Criar".
  3. Informações do App:
    • Nome do App: Gmail CLI
    • E-mail de suporte: Seu e-mail.
  4. Escopos (Scopes):
    • Clique em "Adicionar ou Remover Escopos".
    • Adicione https://www.googleapis.com/auth/gmail.readonly (para leitura).
    • (Futuramente, poderemos precisar de escopos de escrita).
  5. Usuários de Teste:
    • Adicione seu próprio e-mail do Gmail à lista de usuários de teste. Isso é crucial, pois o app não será verificado pelo Google.

4. Criar Credenciais (OAuth Client ID)

  1. Vá para "APIs e Serviços" > "Credenciais".
  2. Clique em "Criar Credenciais" > "ID do cliente OAuth".
  3. Tipo de Aplicativo: Selecione "App para computador" (Desktop App).
  4. Dê um nome (ex: Gmail CLI Desktop).
  5. Clique em "Criar".

5. Baixar o Arquivo JSON

  1. Após criar, uma janela popup aparecerá. Clique em "Fazer o download de JSON".
  2. Salve o arquivo como credentials.json em um local seguro.
  3. IMPORTANTE: Não compartilhe este arquivo com ninguém e não o commite no Git.

6. Configurando no CLI

Agora você pode usar o comando de login do gmail-cli:

gmail auth login --credentials /caminho/para/seu/credentials.json

Isso abrirá o navegador para você autorizar o acesso. Após o sucesso, um token de sessão será salvo em ~/.config/gmail-cli/token.json.