Nó Google Drive

O nó de workflow Google Drive (google_drive_request) chama a Google Drive API v3 para listar, buscar, exportar, criar, atualizar e excluir arquivos. Suporta serviços conectados OAuth (recomendado) e modo de link público para acesso somente leitura sem autenticação.

ID do nó no editor: google_drive_request
Base da API: https://www.googleapis.com/drive/v3/
Variável de token (OAuth): {{google_drive_token}}

O que faz

A cada execução, o engine:

1. Resolve URL, headers, body e seletores de arquivo/pasta
2. Injeta token OAuth do serviço conectado selecionado (a menos que seja modo link público)
3. Opcionalmente resolve file ID por expressão de nome antes de enviar a requisição
4. Retorna status, data e headers

Pré-requisitos

Modo OAuth (ler/gravar arquivos privados)

1. Configurações → Chaves de API → Serviços conectados
2. Adicione Google Drive e conclua o Google OAuth
3. No nó, selecione Serviço conectado (company_service_id) — obrigatório para arquivos privados

O workflow deve estar associado a uma company que possua o serviço conectado.

Modo link público (somente leitura, sem OAuth)

1. Ative Link público (google_drive_public_link: true)
2. Cole uma URL de arquivo do Google Drive acessível publicamente
3. Nenhum serviço conectado necessário — adequado para arquivos publicados ou "anyone with link"

O modo público ignora injeção de token OAuth. Use apenas para arquivos não sensíveis, intencionalmente públicos.

Como configurar

Passo 1 — Adicionar o nó

1. Abra Automações
2. Paleta → Dados → Google Drive
3. Escolha OAuth ou modo link público
4. Escolha um template de operação

Passo 2 — Templates de operação

Passo 3 — Modos de seleção de arquivo

Quando uma operação tem como alvo um arquivo específico:

Name by expression exige:

• Serviço OAuth conectado selecionado
• Folder filter opcional (google_drive_folder_id) para restringir a busca
• Correspondência exata do nome após resolução de variáveis

O engine resolve o nome, busca o file ID via Google Drive API e então envia a requisição.

Exemplo de expressão:

relatorio-{{variables.month}}-{{variables.year}}.xlsx

Passo 4 — Filtro de pasta

Pasta (filtro da lista) restringe o seletor de arquivos e a busca por nome a uma pasta específica. Copie o folder ID da URL do Drive ou escolha na UI.

Padrão de URL para listar arquivos na pasta:

https://www.googleapis.com/drive/v3/files?q='{{folder_id}}'+in+parents&fields=files(id,name,mimeType,modifiedTime)&orderBy=modifiedTime desc&pageSize=50

Passo 5 — Exportar como texto

Exporte Google Docs, Sheets ou Slides para texto simples:

https://www.googleapis.com/drive/v3/files/{{file_id}}/export?mimeType=text/plain

Para arquivos binários (PDF, imagens), use o endpoint de download /files/{id}?alt=media (configure manualmente no campo URL).

Passo 6 — Usar a saída

{{google_drive_1.data}}
{{google_drive_1.data.files}}
{{google_drive_1.status}}

Operações de listagem retornam { "files": [...] }. Export retorna texto bruto em data.

Saídas do nó

Dicas e boas práticas

• Use OAuth para qualquer coisa privada — modo link público é somente leitura e expõe dados a quem tiver a URL
• Restrinja folder filters ao usar expressões de nome para evitar correspondência com arquivo errado
• Export mimeType deve ser suportado para o tipo de arquivo (Docs → text/plain, Sheets → text/csv, etc.)
• Delete é permanente — prefira mover para lixeira via API se precisar de recuperação (trashed: true PATCH)
• Armazene file_id em campos customizados do CRM quando o mesmo arquivo for atualizado repetidamente
• Paginação — endpoints de listagem retornam nextPageToken; encadeie requisições ou aumente pageSize (máx. 1000)
• Combine com Loop para processar cada arquivo em uma listagem de pasta

Exemplos de casos de uso

Enviar PDF de fatura mais recente de pasta do Drive

1. Gatilho Webhook — cliente solicita fatura
2. Google Drive — listar pasta ordenada por modifiedTime desc, pageSize 1
3. Condição — arquivo encontrado
4. Enviar mídia — WhatsApp com URL do arquivo ou conteúdo baixado

Contrato dinâmico por código de pedido

1. Variável — order_code do gatilho
2. Google Drive — expressão de nome contrato-{{variables.order_code}}.pdf, export ou download
3. Enviar mensagem — anexar ou enviar link ao cliente

Arquivar pasta de negócios concluídos

1. Gatilho CRM — deal ganho
2. Google Drive — criar pasta em Deals
3. Google Drive — mover/copiar arquivos template (PATCH parents)

FAQ

Erro "Select connected service"?
Modo OAuth exige company_service_id. Conecte Google Drive em Configurações → Chaves de API, ou mude para link público apenas para arquivos públicos.

Arquivo não encontrado com expressão de nome?
O nome deve corresponder exatamente (incluindo extensão). Verifique folder filter e resolução de variáveis nos logs de execução.

403 insufficient permissions?
Reconecte OAuth com escopo Drive, ou compartilhe o arquivo/pasta com a conta Google usada no OAuth.

Posso fazer upload de arquivos novos?
Use endpoints de upload multipart — configure URL/method/body manualmente ou vá além dos templates. Upload exige OAuth.

Link público vs OAuth?
Público = sem token, somente leitura, arquivos anyone-with-link. OAuth = arquivos privados, API completa, acesso de escrita.

Export retorna binário ilegível?
mimeType de export incorreto — use download alt=media para PDFs e imagens, não /export.

Referência da API

Relacionados

• Visão geral de Dados
• Nó Google Sheets
• Visão geral das integrações
• Como integrar o Google Calendar — mesmo padrão de fluxo OAuth Google