MENU
    Conector do Google Sheets
    • 03 Nov 2023
    • 5 Minutos para Ler
    • Contribuintes

    Conector do Google Sheets


    Resumo do artigo

    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


    Este artigo foi útil?