Conector do Google Sheets

Conector do Google Sheets

Introdução

A API do Google Sheets permite que os usuários criem, leiam e editem planilhas do Google com o acesso correto definido em suas contas do Google. O objetivo desse conector é aproveitar o Oauth 2.0 da Tulip para integrar-se ao Google Sheets usando conectores HTTP e fornecer aos nossos clientes um conector pronto para uso que possa ser importado para sua instância.

Objetivo

1. Vamos destacar diferentes funções do conector HTTP que podem ser criadas por meio de chamadas HTTP para endpoints da API (v4) do Google Sheets para interagir com a planilha do Google e experimentar várias ações de leitura e gravação na planilha que podem ser aproveitadas para vários casos de uso.

Documento da API

1. Documento de referência da API do Google Sheets

Pré-requisitos

1. Crie uma conta no Console de nuvem do Google e configure as credenciais do OAuth 2.0. Mais informações podem ser encontradas nos documentos da API do Google.
2. Adicione o URL de redirecionamento das instâncias no console de nuvem do Google

Detalhes da conexão Tulip

As informações a seguir precisariam ser configuradas nos conectores do Tulip.

1. Em execução: host do conector de nuvem
2. Host: sheets.googleapis.com
3. Porta:443
4. TLS: Sim
5. OAuth 2(Admin): A autenticação será transferida para todas as funções do Connector

Funções do conector

Nova planilha do Google

Objetivo

1. Os usuários podem passar um Spreadsheet Name e SheetName como entrada e o Tulip criará uma nova planilha com o nome da planilha fornecido. A resposta da API serão os metadados e várias propriedades da planilha, que podem ser usados como filtros para buscar e atualizar dados das planilhas.
2. As informações extraídas da API V4 das planilhas do Google podem ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip que seriam canalizadas para outras funções do conector.

Ponto final

Chamada HTTP POST para o ponto de extremidade https://sheets.googleapis.com/v4/spreadsheets

Entrada obrigatória

A seguir estão os parâmetros que são enviados como corpo da solicitação

1. SpreadSheet Name - O título da planilha
2. Sheet Name - Título inicial da planilha

Extrator de saída

1. Planilha: Identificador exclusivo da SpreadSheet que será usada para executar as outras tarefas
2. URL da planilha: O URL da planilha recém-criada

Google Get SpreadSheet Data (Obter dados da planilha)

Objetivo

Esse conector buscará os dados do spreadsheetId fornecido dentro do intervalo determinado. Os dados serão fornecidos como uma matriz de linhas ou colunas com base nos parâmetros de consulta fornecidos à função do conector

Ponto final

Chamada HTTP GET para o ponto de extremidade -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados

1. SpreadSheet Id (ID da planilha)
2. Range - Uma cadeia de caracteres em [A1 Format](https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Os parâmetros de consulta adicionais que serão fornecidos pelas funções do conector são

1. majorDimension : ROWS ou COLUMNS decide qual deve ser a matriz de dados interna
2. dateTimeRenderOption especifica o formato dos campos DateTime; valor padrão: FORMATTED_STRING
3. valueRenderOption especifica se os dados devem ser formatados ou não formatados na resposta; valor padrão: FORMATTED_VALUE

Extrator de saída

1. Valores: Esta é uma matriz de matrizes, cada linha de dados será uma matriz.

Planilha do Google InsertRow

Finalidade

Acrescenta valores a uma planilha. O intervalo de entrada é usado para pesquisar dados existentes e encontrar uma "tabela" dentro desse intervalo. Os valores serão anexados à próxima linha da tabela, começando com a primeira coluna da tabela. O Connector receberá spreadsheetId, Range e a lista de valores a serem inseridos nas células.

Ponto de extremidade

Chamada HTTP POST para o ponto de extremidade -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

Entrada obrigatória

A seguir estão os parâmetros de consulta que devem ser passados

1. ID da planilha
2. Intervalo
3. Valores: para esse conector, consideramos 8 valores de coluna com cada parâmetro nomeado de acordo com a coluna que será inserida. Isso será passado para a API como uma matriz de valores

Os parâmetros de consulta adicionais que serão fornecidos pelas funções do conector são

1. valueInputOption: Esse é um campo obrigatório e será enviado pelo conector, com valor padrão definido: USER_ENTERED

Extrator de saída

1. spreadsheetId
2. UpdatedRows: Especifica o número de linhas que foram inseridas

Limpar planilha do Google

Finalidade

Limpa valores de uma planilha. O chamador deve especificar o ID e o intervalo da planilha. Somente os valores são apagados - todas as outras propriedades da célula (como formatação, validação de dados, etc.) são mantidas. O Connector receberá spreadsheetId, Range e a lista de valores a serem inseridos nas células.

Ponto de extremidade

Chamada HTTP POST para o ponto de extremidade -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear

Entrada obrigatória

A seguir estão os parâmetros de consulta que devem ser passados

1. ID da planilha
2. Intervalo

Google Get SpreadSheet Details byFilter (Obter detalhes da planilha por filtro)

Objetivo

Esse conector buscará os detalhes da planilha com o spreadsheetId fornecido e a condição específica especificada no filtro de dados.

Ponto final

Chamada HTTP POST para o ponto de extremidade -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter

Entrada obrigatória

A seguir estão os parâmetros de consulta que devem ser passados

1. spreadSheetId
2. includeGridData: O valor padrão é False

Os seguintes parâmetros são enviados como parte do corpo da solicitação no formato JSON

1. gridRange

Extratores de saída

1. spreadSheetId
2. Título
3. Localidade
4. recalcamento automático
5. timeZone
6. sheetId
7. sheetTitle
8. sheetType
9. sheetRowCount
10. sheetColumnCount
11. spreadSheetUrl

Há outros parâmetros que podem ser incluídos como parte da saída com base no caso de uso do usuário

Google Get Batch Data

Objetivo

Esse conector buscará os dados da spreadsheetId fornecida dentro de O Data será fornecido como uma matriz de linhas ou colunas com base nos parâmetros de consulta fornecidos ao conector

Ponto final

Chamada HTTP GET para o ponto de extremidade -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

Entrada obrigatória

A seguir estão os parâmetros de consulta que devem ser passados

1. Id da planilha
2. Range - Uma cadeia de caracteres em [A1Format](https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Os parâmetros de consulta adicionais que serão fornecidos pelas funções do conector são

1. majorDimension : ROWS ou COLUMNS decide qual deve ser a matriz de dados interna
2. dateTimeRenderOption especifica o formato dos campos DateTime; valor padrão: FORMATTED_STRING
3. valueRenderOption especifica se os dados devem ser formatados ou não formatados na resposta valor padrão: FORMATTED_VALUE

Extrator de saída

1. valueRanges: Essa é uma matriz de objetos. Cada objeto detalha um intervalo

Filtro Google Get Batch Data

Objetivo

Esse conector buscará os dados da planilhaId fornecida dentro da condição de filtro fornecida como um lote de dados. Os dados serão fornecidos como uma matriz de linhas ou colunas com base nos parâmetros de consulta fornecidos ao conector

Ponto de extremidade

Chamada HTTP POST para o ponto de extremidade -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter

Entrada obrigatória

A seguir estão os parâmetros de consulta que devem ser passados

1. SpreadSheet Id (ID da planilha)

Os parâmetros adicionais do Request Body que serão fornecidos pelas funções do conector são

1. Filtros de dados
2. majorDimension : ROWS ou COLUMNS decide qual deve ser a matriz de dados interna
3. dateTimeRenderOption especifica o formato dos campos DateTime; valor padrão: FORMATTED_STRING
4. valueRenderOption especifica se os dados devem ser formatados ou não formatados na resposta valor padrão: FORMATTED_VALUE

Extrator de saída

1. valueRanges: Essa é uma matriz de objetos. Cada objeto detalha um intervalo

Vídeo