📧📊📁📅

Google Suite

Gmail • Sheets • Drive • Calendar

Guia completo para configurar OAuth 2.0 no Google Cloud Console e conectar todos os serviços Google ao N8N.

🎯

Visão Geral

O Google usa OAuth 2.0 para autenticação. Isso significa que você precisa criar um "App" no Google Cloud Console, configurar credenciais e autorizar o N8N a acessar sua conta.

📧

Gmail

Enviar, ler, organizar emails

📊

Sheets

CRUD em planilhas

📁

Drive

Upload, download, compartilhar

📅

Calendar

Eventos, agendamentos

1

Criar Projeto no Google Cloud Console

1.1 Acessar o Console

  1. → Acesse console.cloud.google.com
  2. → Faça login com sua conta Google (use a conta que terá acesso aos dados)
  3. → Se for a primeira vez, aceite os termos de serviço

1.2 Criar Novo Projeto

  1. → Clique no dropdown no topo (ao lado do logo Google Cloud)
  2. → Clique em "Novo Projeto"
  3. → Nome do projeto: n8n-automacoes (ou qualquer nome descritivo)
  4. → Organização: deixe como está (ou selecione se tiver)
  5. → Clique em "Criar" e aguarde (pode levar 30 segundos)

⚠️ Importante

Após criar o projeto, certifique-se de que ele está selecionado no dropdown do topo. Todas as configurações seguintes devem ser feitas DENTRO deste projeto.

2

Ativar as APIs Necessárias

Cada serviço Google tem sua própria API que precisa ser ativada individualmente:

Como ativar:

  1. 1. No menu lateral, clique em "APIs e Serviços" → "Biblioteca"
  2. 2. Na barra de pesquisa, digite o nome da API
  3. 3. Clique na API desejada e depois em "Ativar"

📧 Para Gmail:

  • → Pesquise: Gmail API
  • → Clique e ative

📊 Para Sheets:

  • → Pesquise: Google Sheets API
  • → Clique e ative

📁 Para Drive:

  • → Pesquise: Google Drive API
  • → Clique e ative

📅 Para Calendar:

  • → Pesquise: Google Calendar API
  • → Clique e ative

💡 Dica: Ative todas as APIs que você pretende usar agora. Não precisa voltar depois.

3

Configurar Tela de Consentimento OAuth

3.1 Acessar Configuração

  1. → No menu lateral: "APIs e Serviços" → "Tela de consentimento OAuth"
  2. → Tipo de usuário: selecione "Externo" (a menos que tenha Google Workspace)
  3. → Clique em "Criar"

3.2 Preencher Informações do App

Nome do app:

N8N Automações

Email de suporte:

seu@email.com

Logo:

Opcional (pode pular)

Email do desenvolvedor:

seu@email.com

Clique em "Salvar e Continuar"

3.3 Configurar Escopos (Permissões)

  1. → Clique em "Adicionar ou remover escopos"
  2. → Pesquise e adicione os escopos necessários (ou pule e deixe o N8N pedir depois)
// Escopos comuns para N8N: https://www.googleapis.com/auth/gmail.modify // Gmail https://www.googleapis.com/auth/spreadsheets // Sheets https://www.googleapis.com/auth/drive // Drive https://www.googleapis.com/auth/calendar // Calendar

Clique em "Salvar e Continuar"

3.4 Adicionar Usuários de Teste

⚠️ CRÍTICO - Não pule este passo!

Enquanto o app estiver em modo "Teste", APENAS os emails adicionados aqui poderão se conectar.

  1. → Clique em "Add Users"
  2. → Adicione o email da conta Google que você vai conectar ao N8N
  3. → Clique em "Salvar e Continuar" → "Voltar ao Painel"
4

Criar Credenciais OAuth 2.0

4.1 Criar ID do Cliente OAuth

  1. 1. No menu lateral: "APIs e Serviços" → "Credenciais"
  2. 2. Clique em "+ Criar Credenciais" → "ID do cliente OAuth"
  3. 3. Tipo de aplicativo: "Aplicativo da Web"
  4. 4. Nome: N8N OAuth

4.2 Configurar URIs de Redirecionamento (IMPORTANTE!)

Em "URIs de redirecionamento autorizados", adicione:

// Para N8N Cloud: https://app.n8n.cloud/rest/oauth2-credential/callback // Para N8N Self-Hosted (substitua pelo seu domínio): https://seu-dominio.com/rest/oauth2-credential/callback // Para N8N Local (desenvolvimento): http://localhost:5678/rest/oauth2-credential/callback

⚠️ A URL precisa ser EXATA. Qualquer caractere diferente causa erro.

4.3 Copiar as Credenciais

Após clicar em "Criar", você verá:

Client ID:

123456789-xxxxx.apps.googleusercontent.com

Client Secret:

GOCSPX-xxxxxxxxxxxxxx

📋 Copie ambos! Você vai precisar no N8N.

5

Configurar no N8N

5.1 Criar Credencial no N8N

  1. 1. No N8N, vá em Credenciais (menu lateral)
  2. 2. Clique em "Adicionar Credencial"
  3. 3. Pesquise pelo serviço desejado (ex: Google Sheets OAuth2 API)

5.2 Preencher os Dados

Client ID:

Cole o Client ID do Google Console

Client Secret:

Cole o Client Secret do Google Console

5.3 Conectar a Conta

  1. 1. Clique em "Sign in with Google" (ou botão similar)
  2. 2. Uma nova aba abrirá para login no Google
  3. 3. Selecione a conta (deve ser uma das adicionadas como usuário de teste!)
  4. 4. Vai aparecer um aviso "App não verificado" - clique em "Avançado" → "Ir para N8N Automações (não seguro)"
  5. 5. Conceda as permissões solicitadas
  6. 6. A aba fecha automaticamente e a credencial está conectada!
📋

Exemplos Práticos no N8N

📧 Gmail - Enviar Email

// Node: Gmail // Operation: Send To: cliente@email.com Subject: Novo pedido recebido Message: Olá {{ $json.nome }}, Seu pedido #{{ $json.pedido_id }} foi confirmado!

📊 Sheets - Adicionar Linha

// Node: Google Sheets // Operation: Append Spreadsheet: Leads 2024 Sheet: Janeiro Values: A: {{ $json.nome }} B: {{ $json.email }} C: {{ $json.telefone }} D: {{ $now.format('dd/MM/yyyy') }}

📁 Drive - Upload de Arquivo

// Node: Google Drive // Operation: Upload File Name: relatorio_{{ $now.format('yyyy-MM') }}.pdf Parents: 1ABC...xyz (ID da pasta) Binary Property: data // O arquivo vem de um node anterior // como HTTP Request ou Read Binary

📅 Calendar - Criar Evento

// Node: Google Calendar // Operation: Create Calendar: primary Summary: Reunião com {{ $json.cliente }} Start: {{ $json.data_reuniao }} End: {{ $json.data_reuniao_fim }} Description: Assunto: {{ $json.assunto }} Attendees: - {{ $json.email_cliente }}
🔧

Troubleshooting

❌ "Error 400: redirect_uri_mismatch"

Causa: A URL de callback no Google não bate com a do N8N.

Solução: Verifique a URL exata nas credenciais do Google Console. Atenção a http vs https e presença de barra no final.

❌ "Access blocked: This app's request is invalid"

Causa: Tela de consentimento não configurada ou projeto errado selecionado.

Solução: Complete a configuração da tela de consentimento OAuth e verifique se o projeto correto está selecionado.

❌ "Error 403: access_denied"

Causa: O email não está na lista de usuários de teste.

Solução: Adicione o email em "Tela de consentimento OAuth" → "Usuários de teste".

❌ Token expira frequentemente

Causa: Apps em modo "teste" têm tokens com validade de 7 dias.

Solução: Publique o app (envie para verificação do Google) ou reconecte a credencial periodicamente.

Google Suite Configurado!

Agora você pode automatizar Gmail, Sheets, Drive e Calendar no N8N.

Próximo: WhatsApp API → Ver Todas as Conexões