Conecte o Google Sheets ao n8n

O Node Google Sheets lê, insere e atualiza linhas de planilhas. Você escolhe o documento, a aba e a ação antes de relacionar os campos do workflow às colunas. Essa separação evita confundir o arquivo inteiro com uma aba específica.

Autenticação na instalação própria

A documentação recomenda OAuth2 para os serviços Google. No n8n self-hosted, configure suas próprias credenciais OAuth2 no Google Cloud. O recurso Managed OAuth2 descrito para o n8n Cloud não está disponível na instalação própria.

Siga o guia oficial de credenciais para criar o projeto, habilitar as APIs necessárias e cadastrar a URL de redirecionamento exibida pelo n8n. O login autorizado precisa ter acesso à planilha escolhida. Uma credencial conectada não concede acesso a qualquer arquivo do Google Drive.

Documento, aba e ação

No Node, escolha a credencial e use Sheet Within Document em Resource. Em Document, você pode selecionar a planilha pela lista, URL ou identificador. Em Sheet, escolha a aba pela lista, URL, identificador ou nome.

Ação	Resultado
Get Row(s)	Lê linhas da aba
Append Row	Acrescenta uma linha
Update Row	Atualiza uma linha existente
Append or Update Row	Atualiza uma correspondência ou acrescenta uma linha

Para um primeiro teste de escrita, use uma aba separada e selecione Append Row. Assim você consegue comparar a entrada do Node com uma linha nova sem alterar registros anteriores.

Mapeie as colunas

Em Mapping Column Mode, escolha Map Each Column Manually para indicar os valores de cada coluna. Com Map Automatically, os nomes dos campos recebidos precisam coincidir com os cabeçalhos da planilha. Um Node Edit Fields anterior pode ajustar esses nomes.

Por exemplo, uma coluna chamada email deve receber o campo correspondente do item. Confira também a configuração para campos extras: o mapeamento automático pode criar novas colunas, ignorar campos excedentes ou encerrar com erro, conforme a opção escolhida.

Confira na própria planilha

Execute com um item de teste. Abra a aba selecionada e compare cada célula com a entrada enviada. Depois, escolha entre acrescentar linhas e atualizar correspondências conforme a rotina desejada. Repetir Append Row acrescenta outra linha. Essa ação não procura uma linha anterior para atualizar.