Para o n8n ler e escrever numa folha do Google Sheets, precisa de uma credencial que prove à Google que o n8n tem licença para mexer nessa folha. Há dois caminhos: entrar com uma conta Google (OAuth), ou usar uma conta de serviço, que é uma conta de robô a quem partilha a folha. A Google e o n8n vão mudando os ecrãs, por isso este artigo explica a lógica e deixa os cliques para a documentação oficial dos dois.
Qual dos dois caminhos
|
Conta Google (OAuth) |
Conta de serviço |
| Como funciona |
O n8n pede à Google autorização em nome de uma pessoa. |
Uma conta de robô, com o seu endereço, que se junta à folha como um colaborador. |
| Acesso |
A tudo o que essa pessoa vê, conforme a autorização dada. |
Só às folhas que lhe partilhar. |
| Precisa do n8n com HTTPS |
Sim: a Google devolve a pessoa a um endereço do seu n8n. |
Não. |
| Se a pessoa sai da empresa |
O fluxo pára, porque a conta é dela. |
Nada muda. |
Para uma empresa, a conta de serviço é a escolha mais segura e estável. O OAuth é mais rápido de montar para um ensaio pessoal.
O fluxo, do princípio ao fim
| 1 |
Tenha um projecto na Google Cloud e active nele a API do Google Sheets. A Google pode pedir também a da Drive, para o n8n listar as folhas: se aparecer um erro a dizer que uma API não está activa, é isto.
|
|
| 2 |
Crie a credencial. Para OAuth, crie as credenciais de cliente na Google e ponha no n8n o identificador e o segredo. O n8n mostra-lhe o endereço de retorno que a Google tem de aceitar; copie-o tal como está. Por isso o n8n precisa de ter HTTPS e de saber o seu endereço, como em n8n com HTTPS no seu domínio.
|
|
| 3 |
Para a conta de serviço, a Google dá-lhe um ficheiro com a chave. O n8n pede o endereço da conta e a chave. Depois abra a folha e partilhe-a com o endereço da conta de serviço, como faria com uma pessoa.
|
|
| 4 |
Prepare a folha. A primeira linha são os cabeçalhos; o n8n usa-os como nomes das colunas. Não mude os cabeçalhos depois de montar o fluxo, ou ele deixa de os encontrar.
|
|
| 5 |
Escolha a operação no nó: ler linhas, acrescentar uma linha, ou actualizar uma linha que tenha um valor numa coluna. Para actualizar, escolha uma coluna com valores únicos (um número de pedido, por exemplo).
|
|
| 6 |
Teste com uma folha de ensaio antes de apontar para a verdadeira.
|
|
|
«Funcionava e deixou de funcionar». Com OAuth, se a aplicação na Google ficar em modo de teste, a autorização pode expirar passado algum tempo e o fluxo começa a falhar sem ninguém ter mexido em nada. A Google explica as regras do estado da aplicação na sua documentação; é a primeira coisa a ver. A conta de serviço não tem este problema.
|
Cuidados com a folha
| Situação |
O que fazer |
| Muitas linhas de uma vez |
Envie em lotes, em vez de uma chamada por linha. A Google limita os pedidos por minuto. |
| Duas execuções ao mesmo tempo |
Podem escrever na mesma linha. Evite-o, ou grave numa folha à parte e junte depois. |
| Dados sensíveis |
Uma folha é fácil de partilhar por engano. Limite quem a vê. |
|
Escreva também a data e a origem em cada linha que o fluxo acrescenta. Quando algo parecer estranho, sabe de onde veio.
|
PRODUTO RECOMENDADO Alojamento de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 5.940,00 Kz/mês (plano de 3 anos, com cupão) Ver planos |
Português
English
