Visao Geral
A conexao com Google Workspace permite acessar Gmail, Google Drive, Google Sheets, Google Docs, Google Calendar e People API atraves de uma unica configuracao OAuth2.
Dificuldade
Media
Custo
Gratis
Auth
OAuth2
Servicos Incluidos
Gmail
Google Drive
Google Sheets
Google Docs
Google Calendar
People API
Pre-requisitos
- Conta Google
- Acesso ao Google Cloud Console (console.cloud.google.com)
Passo a Passo
1
Criar Projeto no Google Cloud
1. Acesse console.cloud.google.com
2. Clique em "Select Project" > "New Project"
3. Nomeie o projeto (ex: "N8N-Automacoes")
4. Clique em "Create"
2
Configurar OAuth Consent Screen
1. Menu lateral > APIs & Services > OAuth consent screen
2. Selecione "External"
3. Preencha:
- App name: Nome da sua aplicacao
- User support email: Seu email
- Developer contact: Seu email
4. Clique em "Save and Continue"
5. Em Scopes, adicione os escopos necessarios:
- Gmail: gmail.readonly, gmail.send, gmail.modify
- Drive: drive.file, drive.readonly
- Sheets: spreadsheets
- Calendar: calendar.events
6. Em Test users, adicione seu email
7. Salve
3
Criar Credenciais OAuth
1. Menu lateral > APIs & Services > Credentials
2. Clique em "+ Create Credentials" > "OAuth client ID"
3. Application type: Web application
4. Name: N8N Integration
5. Authorized redirect URIs:
- Para Make: https://www.make.com/oauth/cb/google-restricted
- Para n8n: sua URL do n8n + /rest/oauth2-credential/callback
6. Clique em "Create"
7. Copie o Client ID e Client Secret
4
Habilitar APIs
Menu lateral > APIs & Services > Library
Habilite as APIs necessarias:
- Gmail API
- Google Drive API
- Google Sheets API
- Google Calendar API
- People API
- Google Docs API
5
Conectar no N8N/Make
1. Adicione modulo Google (Gmail, Drive, etc)
2. Clique em "Add" para criar conexao
3. Cole o Client ID e Client Secret
4. Autorize com sua conta Google
5. Conexao estabelecida!
Escopos (Scopes) por Servico
| Servico | Escopo |
|---|---|
| Gmail | gmail.readonly, gmail.send, gmail.modify |
| Drive | drive.file, drive.readonly |
| Sheets | spreadsheets |
| Calendar | calendar.events |
| Docs | documents |
Conceitos-Chave
OAuth
Protocolo de autorizacao segura
Scope
Permissoes especificas de acesso
Client ID
Identificador da aplicacao
Client Secret
Chave secreta (nunca compartilhe!)
Refresh Token
Token para renovar acesso
Troubleshooting
Erro 403
Verifique se as APIs estao habilitadas no console
Token expirado
Reconecte a integracao no N8N/Make
Acesso negado
Adicione seu email em Test Users no OAuth Consent Screen