Para acessar um arquivo do Google Sheet, é necessário criar uma conexão com o Google, criando uma conta de serviço

Conta de serviço

Uma conta de serviço é um tipo especial de conta do Google que se destina a representar um usuário que precisa se autenticar para acessar os dados da API do Google.

Por ser uma conta separada, por padrão, ela não tem acesso a uma planilha até que uma seja compartilhada com ela, assim como uma conta normal.

Ativação do acesso à API em um projeto

Primeiro, você precisa habilitar o acesso à API para um projeto, o que pode ser feito seguindo estas etapas:

acesse o Google Developer Console e crie um novo projeto (ou selecione o que você já tem).

Na caixa que diz "Search for APIs and services" (Pesquisar APIs e serviços), pesquise "Google Drive API" e ative-a.

Como obter uma conta de serviço

Para obter uma conta de serviço, você deve seguir as seguintes etapas:

Habilite o acesso à API para um projeto, caso ainda não o tenha feito (etapa anterior).
Vá em "APIs e Serviços > Credenciais" e escolha "Criar Credenciais > Chave de Conta de Serviço".
Preencha o formulário.

Clique em “Criar” e depois em “Concluído”.
Toque em "Gerenciar contas de serviço" em Contas de serviço.

Clique em ⋮ próximo à conta de serviço recém-criada e selecione “Gerenciar chaves” e clique em “ADICIONAR CHAVE> Criar uma nova chave”.

Selecione o tipo de chave JSON e clique em “Criar”.

Pressionar "Criar" fará o download das credenciais automaticamente:

{
    "type": "service_account",
    "project_id": "api-project-XXX",
    "private_key_id": "2cd … ba4",
    "private_key": "-----BEGIN PRIVATE KEY-----\nNrDyLw … jINQh/9\n-----END PRIVATE KEY-----\n",
    "client_email": "473000000000-yoursisdifferent@developer.gserviceaccount.com",
    "client_id": "473 … hd.apps.googleusercontent.com",
    ...
}

Lembre-se do caminho do arquivo JSON de credenciais baixado

Habilite permissões em sua planilha

Insira a planilha na qual deseja integrar com o Fracttal.
Clique em compartilhar, e em seguida insira o email que foi gerado na etapa anterior (client_email), com permissões de edição

Você pode realizar esta etapa em todas as planilhas que deseja comunicar com o Fracttal.

Criando a conexão no Fracttal

Após ter as credenciais da conta de serviço (informações encontradas no arquivo JSON) e ter dado permissões de edição à conta de serviço dentro das planilhas, o próximo passo é criar a conexão no Fracttal One:

No Fracttal One, vá em Configurações/Catálogos Auxiliares/Conexões.
Crie uma nova conexão do tipo Planilha Google (Conta de Serviço).
Preencha o formulário com os dados das credenciais baixadas (é importante copiá-las exatamente como aparecem no arquivo baixado, e sem as aspas).
Salvar

Feito isso, está tudo pronto para começar a criar um fluxo de integração dentro do Fracttal HUB, onde a comunicação será entre uma Planilha e o Fracttal One.

Crie o fluxo no Fracttal HUB

Com a conexão criada, resta configurá-la no Fracttal HUB seguindo estes passos:

No Fracttal One, vá para Fracttal HUB.

Crie um novo fluxo.

Na fonte, selecione o módulo Planilha Google.

De acordo com os seguintes campos, preencha as informações solicitadas:

Campo	Descrição
Conexão	Conexão criada no passo anterior, caso não veja volte para o passo “Criar a conexão no Fracttal”
Ação	Tipo de ação a realizar, por enquanto é apenas lida.
spreadsheet_id	ID da planilha à qual queremos acessar. Ele é extraído do URL da planilha. Ex: https://docs.google.com/spreadsheets/d/1Hg289f20983gf29hdf-f28hf9283hf29/ o ID seria "1Hg289f20983gf29hdf-f28hf9283hf29"
sheet	Número da planilha que deseja acessar, começando em 0.
Campos	Nome das colunas das quais você extrairá as informações.

No destino, selecione a ação a ser executada.
Mapeie os campos da planilha com os campos Fracttal.

Defina o tipo de execução como "Trigger".
Salvar

Agora você tem sua planilha conectada ao Fracttal!