Como conectar ou trocar a planilha do bloco Google Sheets

Quando usar

• Para ligar um bloco Google Sheets do seu fluxo a uma planilha pela primeira vez.

• Para trocar a planilha que um bloco já usa.

• Quando o seletor de planilhas pede login no Google e, mesmo logando, a planilha não é aplicada ao bloco.

• Quando, ao conectar a conta Google da sua empresa, aparece "Acesso bloqueado: o admin da sua instituição precisa analisar o app Cloud Humans".

• Quando o bloco mostra uma mensagem de erro sobre a planilha.

Pré-requisitos

• Acesso de edição ao fluxo no Eddie.

• Permissão para compartilhar a planilha no Google Planilhas.

• A planilha precisa ser um arquivo do Google Planilhas. Arquivos .xlsx enviados ao Drive não funcionam até serem convertidos (veja as Observações).

• A primeira linha da planilha precisa ter o nome das colunas. O bloco usa essa linha como cabeçalho.

Sobre este artigo

O bloco Google Sheets lê e grava na planilha usando a conta Google da conexão escolhida no bloco. Essa conexão pode ser de dois tipos:

• Uma conta Google da sua empresa: você mesmo conecta, em Nova conexão. Algumas empresas bloqueiam apps externos no Google Workspace; nesse caso a conexão só funciona depois que a TI da empresa liberar o app Cloud Humans (veja as Observações).

• Uma conta da Cloud Humans (por exemplo, [email protected]): criada pelo time da Cloud Humans para o seu projeto. É o caminho indicado quando a empresa não libera apps externos.

Há também dois jeitos de escolher a planilha: o botão Escolher uma planilha, que abre o seletor do Google, e o campo Ou cole o link da planilha. O seletor do Google só funciona quando o seu navegador está logado na mesma conta Google da conexão. Se a conexão é uma conta da Cloud Humans, use sempre o link.

Para montar um fluxo completo de consulta a uma planilha, veja Como criar um fluxo no Eddie acessando informações em um Google Sheets.

Passo a passo

Etapa 1 — Escolher a conta da conexão

1. Abra o fluxo no Eddie e clique no bloco Google Sheets.

2. No topo das configurações do bloco, escolha a conta na lista de contas:

   • se o seu projeto já tem uma conta da Cloud Humans (termina em @cloudhumans.com), selecione essa conta;

   • para usar a conta Google da sua empresa, clique em Nova conexão e faça login com ela.

3. Anote o e-mail da conta selecionada. É com esse e-mail que a planilha precisa estar compartilhada.

Etapa 2 — Compartilhar a planilha com essa conta

Se a conta da conexão é a dona da planilha, pule esta etapa.

1. Abra a planilha no Google Planilhas e clique em Compartilhar.

2. Adicione o e-mail da conexão (Etapa 1).

3. Escolha a permissão:

   • Leitor, se o bloco só vai ler dados (Get data from sheet);

   • Editor, se o bloco vai inserir ou atualizar linhas (Insert a row ou Update a row).

4. Clique em Enviar.

Etapa 3 — Escolher a planilha no bloco

Colando o link (funciona com qualquer conexão):

1. Com a planilha aberta para edição, copie o link da barra de endereço do navegador. Ele começa com https://docs.google.com/spreadsheets/d/….

2. No bloco, cole o link no campo Ou cole o link da planilha e clique em Usar esta planilha.

   • Se o bloco já tem uma planilha, o campo fica recolhido: clique em Ou cole o link da planilha para abri-lo.

3. O Eddie confere o acesso antes de trocar a planilha. Se der certo, o nome da planilha aparece no bloco. Se der errado, a planilha anterior continua configurada e o bloco mostra o motivo (veja as Observações).

Pelo seletor do Google (só com a conta da sua empresa):

1. Confira que o seu navegador está logado no Google com a mesma conta da conexão.

2. Clique em Escolher uma planilha e selecione a planilha na lista.

Etapa 4 — Conferir a aba e as colunas

1. Em Select the sheet, escolha a aba da planilha.

2. Revise a operação e as colunas configuradas no bloco.

Observações

Mensagens que podem aparecer e o que fazer em cada uma:

• "Acesso bloqueado: o admin da sua instituição precisa analisar o app Cloud Humans" (tela do Google, ao conectar a conta da empresa): o Google Workspace da sua empresa só permite apps aprovados pela TI. Peça à TI para liberar o app Cloud Humans; seu contato na Cloud Humans envia os dados do app que a TI vai pedir. Enquanto isso, use a conta da Cloud Humans do seu projeto e cole o link da planilha.

• "… não tem acesso a esta planilha. Compartilhe a planilha com essa conta e tente de novo.": compartilhe a planilha com o e-mail indicado na mensagem (Etapa 2).

• "Planilha não encontrada. Confira o link e tente de novo.": o link está incompleto ou a planilha foi excluída.

• "Este é um link de 'Publicar na Web'…": links de Arquivo > Compartilhar > Publicar na Web não servem. Cole o link da barra de endereço com a planilha aberta para edição.

• "Isso não parece um link do Google Planilhas": o texto colado não é um link de planilha. Confira se copiou o link inteiro.

• "Este arquivo não é uma planilha do Google Planilhas…": o arquivo é um .xlsx (ou outro formato) enviado ao Drive. Abra no Google Planilhas, use Arquivo > Salvar como Planilhas Google e cole o link do novo arquivo.

• "A conexão "…" expirou ou foi revogada…": a conexão com o Google perdeu a autorização. Se for a conta da sua empresa, conecte de novo em Nova conexão. Se for a conta da Cloud Humans, fale com o seu contato na Cloud Humans.

• "Não foi possível carregar esta planilha. Tente de novo em instantes.": falha temporária. Se continuar, fale com o suporte.