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:

1. 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:

1. Habilite o acesso à API para um projeto, caso ainda não o tenha feito (etapa anterior).

2. Vá em "APIs e Serviços > Credenciais" e escolha "Criar Credenciais > Chave de Conta de Serviço".

   

3. Preencha o formulário.

   

1. Clique em “Criar” e depois em “Concluído”.

2. Toque em "Gerenciar contas de serviço" em Contas de serviço.

   

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

   

7. 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": "[email protected]",
    "client_id": "473 … hd.apps.googleusercontent.com",
    ...
}

Lembre-se do caminho do arquivo JSON de credenciais baixado

Habilite permissões em sua planilha

1. Insira a planilha na qual deseja integrar com o Fracttal.
2. 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:

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

1. No Fracttal One, vá para Fracttal HUB.

2. Crie um novo fluxo.

3. Na fonte, selecione o módulo Planilha Google.

4. 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.

5. No destino, selecione a ação a ser executada.

6. Mapeie os campos da planilha com os campos Fracttal.

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

Agora você tem sua planilha conectada ao Fracttal!