Conectores
Core

Google Sheets

11min

Objetivo/Resumo

Esse conector foi desenvolvido para facilitar a integração e a automação de tarefas com o Google Sheets. Seu objetivo principal é proporcionar aos usuários uma maneira eficiente de acessar, manipular e compartilhar dados em planilhas do Google Sheets diretamente de outras aplicações e serviços. Com esse conector, os usuários podem economizar tempo, reduzir erros manuais e melhorar a colaboração em projetos que envolvam planilhas do Google Sheets.

Criando um fluxo utilizando Conector Google Sheets

Para criar um fluxo utilizando o conector Google Sheets é preciso criar uma conexão e em seguida configurar o fluxo.

Criando conexão Google Sheets

Primeiramente acesse seu projeto no Google Cloud. Em seguida abra o menu lateral e vá em APIs e serviços > Credenciais:

Document image


Nessa tela você terá suas credenciais, crie uma ou então edite uma já existente para que possa ter acesso a opção de adicionar a URI de redirecionamento da Fluid cujo valor a ser setado deve ser:

Text

Document image


Isso forcenerá o consentimento para que a Fluid consiga ter acesso às credenciais do Google Cloud (Gcloud).

É crucial que a sua aplicação no Gcloud tenha ativado o serviço do Google Sheets para que o conector consiga efetuar as operações disponibilizadas.

Parametrização

Após adicionar a URI de redirecionamento, é necessário criar uma conexão na Fluid, fornecendo Parametrizações requisitadas. Clique aqui para acessar o passo a passo para criar a conexão.

Estes são os parâmetros de configuração da conexão com Google Sheets que serão requisitados na criação:

  • Nome: parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório);
  • Descrição: parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão;
  • ID do Cliente: informe o client_id da aplicação (campo obrigatório);
  • Chave Secreta do Cliente: informe o client_secret da aplicação (campo obrigatório);

Configurando fluxo com Google Sheets

Crie um fluxo (passo a passo aqui) e arraste o conector Google Sheets para o canvas.

Document image


Selecione o conector e na aba de Parametrização preencha os seguintes parâmetros de configuração:

  • Recurso: entidade para qual será realizada a ação.
  • Operação: ação que será realizada para o recurso selecionado.
    • Operações disponíveis para recurso Planilha/Documento:
      • Criar planilha: requer o preenchimento do campo "Título" para nomear a planilha e opcionalmente pode ser informado o nome da página. Caso o nome não seja informado, será criado por padrão Página1;
    • Operações disponíveis para recurso Página dentro da Planilha:
      • Adicionar ou editar dados: requer o 'ID da planilha' e o 'Conteúdo' a ser adicionado ou editado, podendo ser eviado utilizando De/para ou Template. O nome da página e o intervalo de linhas e colunas são opcionais;
      • Adicionar página: requer o 'ID da planilha' e o 'Título' da página a ser inserida;
      • Excluir página: requer o 'ID da planilha' e o 'ID da página' a ser excluída;
      • Ler todas as linhas: requer o 'ID da planilha' e o 'nome da página' onde será feita a busca, e de maneira opcional pode ser ativado o 'Tratar Cabeçalho', caso possua cabeçalho na planilha o conector retornará o resultado em formato JSON;
      • Limpar página: requer os campos 'ID da planilha', 'ID da página', linha inicial, linha final, coluna inicial e coluna final para mapear a limpeza da página;
      • Remover linhas ou colunas: requer os campos 'ID da planilha', 'ID da página', Dimensão (escolha o que deseja remover se uma linha ou se uma coluna), linha ou coluna inical e linha ou coluna final;
      • Mesclar células: requer os campos, 'ID da planilha', 'ID da página', linha inicial, linha final, coluna inicial e coluna final para mapear as células a serem mescladas;

Na aba Propriedades selecione a conexão desejada, dê um nome ao 'Passo' e se necessário detalhe uma descrição.

Na prática

Neste tópico criaremos um fluxo utilizando o conector do Google Sheets. O fluxo terá dois passos, sendo eles criar e inserir, onde será criada uma planilha e na sequência alimentaremos ela com dados.

Document image


Passo criar

Assim ficará a Parametrização do nosso primeiro passo:

Document image


Na aba Propriedades informamos o nome do passo e a conexão criada para o Google Sheets:

Document image


Passo inserir

Assim ficará a Parametrização do nosso último passo:

Document image


Os dados a serem inseridos na planilha estão fixos no Template. E assim ficou nosso template:

Document image


OBS: O Google Sheets espera como entrada um array de array [][]. Então é necessário preparar o De/Para ou Template para que seja enviado o esperado pelo sheets.



Na aba Propriedades informamos o nome do passo e a conexão criada para o conector Google Sheets:

Document image


Disparando o Fluxo

Com os passos configurados basta disparar o fluxo. Nesse caso não precisaremos informar um payload de entrada, pois os dados que estamos usando no exemplo estão fixos no conector. Após o disparo, o resultado do fluxo será apresentado em tempo real no canvas:

Document image


Abrindo os detalhes do passo 'criar' temos o link da planilha criada:

Document image


Ao acessar o link da resposta, vemos o resultado do nosso fluxo por completo:

Document image