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.

O que você pode fazer​

  • Ler dados de planilhas existentes
  • Criar novas linhas automaticamente
  • Atualizar células específicas
  • Deletar dados quando necessário
  • Criar novas planilhas programaticamente
  • Gerenciar permissões de acesso

Pré-requisitos​

1. Conta Google​

  • Conta Google ativa
  • Acesso ao Google Sheets

2. Credenciais OAuth2​

  • Criar projeto no Google Cloud Console
  • Ativar Google Sheets API
  • Configurar OAuth2 credentials

Configuração Rápida​

1. Criar Credencial​

  1. Vá em: Credentials → Add new
  2. Escolha: Google OAuth2 API
  3. Configure: Client ID e Client Secret
  4. Autorize: Sua conta Google

2. Adicionar Node​

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

Operações Disponíveis​

Read (Ler Dados)​

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

Append (Adicionar Linha)​

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

Update (Atualizar Dados)​

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

Clear (Limpar Dados)​

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

Casos de Uso Populares​

Lead Capture​

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

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

Relatórios Automáticos​

Schedule → API Call → Transform → Google Sheets

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

E-commerce Sync​

Shopify Webhook → Google Sheets → Email Notification

Cenário: Novos pedidos salvos em planilha

CRM Integration​

Google Sheets → CRM API → Slack Notification

Cenário: Sincronizar dados entre sistemas

Dicas e Truques​

Performance​

  • Use ranges específicos em vez de ler planilha inteira
  • Batch operations para múltiplas linhas
  • Cache data quando possível

Segurança​

  • Permissions mínimas nas credenciais OAuth2
  • Validate data antes de escrever
  • Use service accounts para produção

Responsividade​

  • Error handling para conexões lentas
  • Retry logic para operações falhadas
  • Timeout settings apropriados

Configurações Avançadas​

Service Account (Recomendado para Produção)​

{
"type": "service_account",
"project_id": "seu-projeto",
"private_key_id": "key-id",
"private_key": "-----BEGIN PRIVATE KEY-----\n...\n",
"client_email": "service@projeto.iam.gserviceaccount.com"
}

Batch Updates​

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

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

Links Úteis​

Próximos passos: Configure suas credenciais OAuth2 e comece a automatizar suas planilhas!