Pular para o conteúdo principal

Google Sheets

A integração do Google Sheets é uma das mais populares do n8n, permitindo automatizar completamente suas planilhas e dados.

Configuração​

1. Adicionar Node​

  1. Busque: "Google Sheets" no menu de nodes
  2. Arrastar: Para o canvas
  3. Conectar: Sua credencial OAuth2

2. Configurar Credenciais​

Nota importante: As credenciais mostradas abaixo são apenas exemplos. Nunca use credenciais reais em documentação ou código de exemplo.

{
  "type": "service_account",
  "project_id": "exemplo-projeto",
  "private_key_id": "exemplo-key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\nEXEMPLO-DE-CHAVE-PRIVADA-NAO-USE-EM-PRODUCAO\n-----END PRIVATE KEY-----\n",
  "client_email": "service@exemplo-projeto.iam.gserviceaccount.com"
}

Operações Principais​

Read - Ler Dados​

{
  "operation": "read",
  "documentId": "SEU_GOOGLE_SHEET_ID_AQUI",
  "sheetName": "Class Data",
  "range": "A2:F"
}

Append - Adicionar Linha​

{
  "operation": "append",
  "documentId": "SEU_GOOGLE_SHEET_ID_AQUI",
  "sheetName": "Sheet1",
  "values": [
    ["João", "joao@email.com", "Premium", "2024-01-15"]
  ]
}

Update - Atualizar Dados​

{
  "operation": "update",
  "documentId": "SEU_GOOGLE_SHEET_ID_AQUI",
  "sheetName": "Sheet1",
  "range": "B2",
  "values": [["Novo Valor"]]
}

Clear - Limpar Dados​

{
  "operation": "clear",
  "documentId": "SEU_GOOGLE_SHEET_ID_AQUI",
  "sheetName": "Sheet1",
  "range": "A1:F10"
}

Batch Updates - Atualizações em Lote​

{
  "operation": "batchUpdate",
  "requests": [
    {
      "updateCells": {
        "range": "Sheet1!A1:B2",
        "rows": [
          {"values": [{"userEnteredValue": {"stringValue": "Nome"}}]},
          {"values": [{"userEnteredValue": {"stringValue": "João"}}]}
        ]
      }
    }
  ]
}

Casos de Uso Populares​

Lead Capture​

Workflow: Webhook → Validação → Google Sheets (Append)

Cenário: Formulário no site salva leads automaticamente

Relatórios Automáticos​

Workflow: Schedule → API Call → Transform → Google Sheets

Cenário: Relatórios diários de vendas

E-commerce Sync​

Workflow: Webhook → Google Sheets → Email Notification

Cenário: Novos pedidos salvos em planilha

CRM Integration​

Workflow: Google Sheets → CRM API → Slack Notification

Cenário: Sincronizar dados entre sistemas

Troubleshooting​

Erro: Invalid Credentials​

# Verificar Client ID e Secret
# Reautorizar no OAuth2
# Confirmar APIs habilitadas

Erro: Permission Denied​

# Verificar permissões da planilha
# Confirmar email do service account
# Testar com editor permissions

Erro: Quota Exceeded​

# Implementar rate limiting
# Usar batch operations
# Considerar service account

Recursos Adicionais​