Passar para o conteúdo principal

Google Sheets

Atualizado há mais de um mês

Autenticação

Para que a Uncover consiga ler dados de suas planilhas do Google Sheets, é necessário fazer "sign in" na plataforma. O usuário fazendo sign in precisa ter, no mínimo, permissão de leitura sobre a planilha sendo conectada.

Por enquanto, a autenticação precisa ser feita por um usuário com email no domínio uncover.co

Requisitos de qualidade de dados

Para garantir que a conexão funcionará corretamente, as abas da planilha precisam seguir alguns padrões de qualidade. O ideal é que todas as abas (mesmo as não conectadas) sigam um formato "tabular", isso é, o mais próximo possível de um arquivo CSV. A lista abaixo descreve alguns direcionamentos, mas não é extensiva.

  1. Linha de header: todas as abas precisam conter a primeira linha com o nome da respectiva coluna;

  2. Colunas vazias: nenhuma coluna deve ser inteiramente vazia, isso é, não conter sequer o header;

  3. Linha de total: as abas não devem conter linhas de total no fim dos dados;

  4. Células com fórmulas: não são recomendadas;

  5. Fórmulas com erro: não deve haver células com erro de fórmula;

  6. Colunas repetidas: cada nome de coluna deve ser único dentro de uma aba;

  7. Coluna de data: uma coluna de data precisa existir, não ter valores nulos em nenhuma linha e conter um único formato (não se pode, por exemplo, misturar os formatos "YYYY-MM-DD" e "DD/MM/YYYY" na mesma coluna);

  8. Valores numéricos: devem ter separador de decimal "." (ponto) e não devem ter separador de milhar;

  9. Gráficos e tabelas dinâmicas: não devem ser incluídos,

  10. Caracteres especiais nos nomes das abas: devem ser evitados.

Se algum cálculo ou validação de dados precisa ser realizada, a recomendação é que isso seja feito sempre em um documento separado, mantendo o documento conectado apenas com os dados a serem integrados, sendo esse usado exclusivamente para o propósito de transferência de dados.

Configurações do provider

O provider recebe os seguintes campos de configuração:

Configuração

Significado

Spreadsheet URL

Link do documento Google Sheets a ser conectado

Tabelas disponíveis

Estarão disponíveis para conexão todas as tabelas presentes no documento.

Configurações das tabelas

As configurações devem ser feitas conforme documentado em Entendendo Data Sources. É recomendável fazer uso da configuração de tipos de dados das colunas como garantia de qualidade dos dados.

Limitações

O documento precisa ser uma planilha do Google Sheets "nativa". Documentos Excel (.xlsx) hospedados no Google Drive não podem ser usados.

Após a conexão de um documento,

  • Abas conectadas não podem ser renomeadas ou apagadas

    • Isso levará a erros que exigem o acionamento do suporte da plataforma

  • Colunas não podem ser renomeadas, apagadas, ou criadas

    • Isso pode levar a erros que exigem acionamento do suporte

    • Se é necessário adicionar uma coluna nova na planilha, é necessário recriar a sincronização dessa tabela

Respondeu à sua pergunta?