Conector Google Sheets

Conector Google Sheets

Introducción

Google Sheets API permite a los usuarios crear, leer y editar hojas de Google con el acceso adecuado a sus cuentas de Google. El objetivo de este conector es aprovechar el Oauth 2.0 de Tulip para integrarse con Google Sheets utilizando conectores HTTP y proporcionar a nuestros clientes un conector listo para usar que se puede importar en su instancia.

Propósito

1. Vamos a destacar diferentes funciones de conectores HTTP que se pueden construir haciendo llamadas HTTP a los puntos finales de la API de Google Sheets (v4) para interactuar con la hoja de cálculo de Google para probar varias acciones de lectura y escritura en la hoja de cálculo que podrían ser aprovechadas para diversos casos de uso.

Documento API

1. Documento de referencia del API de Google Sheets

Requisitos previos

1. Crea una cuenta en la consola en la nube de Google y configura las credenciales OAuth 2.0. Puedes encontrar más información en los documentos de la API de Google.
2. Añade la URL de redirección de instancias en la consola en la nube de Google.

Detalles de la conexión a Tulip

La siguiente información debe ser configurada en los conectores de Tulip.

1. Running On: Cloud Connector Host
2. Host:sheets.googleapis.com
3. Puerto:443
4. TLS: Sí
5. OAuth 2(Admin): La autenticación se transmitirá a todas las funciones del conector.

Funciones del conector

Nueva hoja de cálculo de Google

Propósito

1. Los usuarios pueden pasar un nombre de hoja de cálculo y un nombre de hoja como entrada y Tulip creará una nueva hoja de cálculo con el nombre de hoja proporcionado. La respuesta de la API serán los metadatos y varias propiedades de la hoja de cálculo, esto puede ser utilizado como filtros para obtener y actualizar los datos de las hojas de cálculo.
2. La información extraída de Google sheets V4 API puede ser utilizada en aplicaciones Tulip, tablas Tulip, o variables Tulip que pueden ser canalizadas a otras funciones del conector.

Punto final

Llamada HTTP POST al punto final https://sheets.googleapis.com/v4/spreadsheets

Entrada requerida

Los siguientes son los parámetros que se envían como cuerpo de la solicitud

1. SpreadSheet Name - Título de la hoja de cálculo
2. Sheet Name - Título inicial de la hoja

Extractor de salida

1. Hoja de Cálculo: Identificador único de la SpreadSheet que se utilizará para realizar las demás tareas
2. URL de la hoja de cálculo: La URL de la Hoja de Cálculo recién creada

Obtener datos de la hoja de cálculo de Google

Propósito

Este conector obtendrá los datos del SpreadSheetId proporcionado dentro del rango dado. Los datos se proporcionarán como una matriz de filas o columnas en función de los parámetros de consulta proporcionados a la función del conector.

Punto final

Llamada HTTP GET al punto final -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

Entrada obligatoria

Los siguientes son los parámetros de URL que deben pasarse

1. Id. de hoja de cálculo
2. Rango - Una cadena en [Formato A1](https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Los parámetros de consulta adicionales que se suministrarán desde las funciones del conector son

1. majorDimension : ROWS o COLUMNS decide cuál debe ser la matriz de datos interna
2. dateTimeRenderOption especifica el formato de los campos DateTime valor por defecto:FORMATTED_STRING
3. valueRenderOption especifica si los datos deben ser formateados o no en la respuesta valor por defecto: FORMATTED_VALUE

Extractor de salida

1. Valores: Se trata de un Array de Arrays, cada fila de datos será un array.

Google SpreadSheet InsertRow

Propósito

Añade valores a una hoja de cálculo. El rango de entrada se utiliza para buscar datos existentes y encontrar una "tabla" dentro de ese rango. Los valores se añadirán a la siguiente fila de la tabla, empezando por la primera columna de la tabla. El Conector tomará spreadsheetId, Rango y la lista de valores a insertar en las celdas.

Punto final

Llamada HTTP POST al punto final -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

Entrada obligatoria

A continuación se indican los parámetros de consulta que deben introducirse

1. ID de hoja de cálculo
2. Rango
3. Valores: para este conector, hemos considerado 8 valores de columna con cada parámetro nombrado contra la columna que se insertará. Esto se pasará a la API como una matriz de valores.

Los parámetros de consulta adicionales que se suministrarán desde las funciones del conector son :

1. valueInputOption: Este es un campo obligatorio y será enviado desde el conector, Valor por defecto establecido: USER_ENTERED

Extractor de salida

1. spreadsheetId
2. UpdatedRows: Especifica el número de filas que se han insertado

Borrado de Google SpreadSheet

Propósito

Borra valores de una hoja de cálculo. El usuario debe especificar el ID y el rango de la hoja de cálculo. Sólo se borran los valores -- todas las demás propiedades de la celda (como formato, validación de datos, etc..) se mantienen. El Conector tomará spreadsheetId, Range y la lista de valores a insertar en las celdas.

Punto final

Llamada HTTP POST al punto final -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear

Entrada obligatoria

Los siguientes son los parámetros de consulta que deben pasarse

1. ID de hoja de cálculo
2. Rango

Google Obtener detalles de hoja de cálculo por filtro

Propósito

Este conector obtendrá los detalles de la hoja de cálculo con el ID de hoja de cálculo proporcionado y la condición específica especificada en el filtro de datos.

Punto final

Llamada HTTP POST al punto final -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter

Entrada obligatoria

A continuación se indican los parámetros de consulta que deben introducirse

1. spreadSheetId
2. includeGridData: El valor por defecto es False

Los siguientes parámetros se envían como parte del cuerpo de la solicitud en formato JSON

1. gridRange

Extractores de salida

1. spreadSheetId
2. Título
3. Configuración regional
4. auto recalc
5. timeZone
6. sheetId
7. hojaTítulo
8. sheetType
9. sheetRowCount
10. sheetColumnCount
11. spreadSheetUrl

Existen otros parámetros que pueden incluirse como parte de la salida en función del caso de uso del usuario

Obtención de datos por lotes de Google

Propósito

Este conector obtendrá los datos del ID de hoja de cálculo proporcionado Los datos se suministrarán como una matriz de filas o columnas en función de los parámetros de consulta suministrados al conector

Punto final

Llamada HTTP GET al punto final -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

Entrada obligatoria

A continuación se indican los parámetros de consulta que deben introducirse

1. Id. de hoja de cálculo
2. Rango - Una cadena en [A1Format](https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Los parámetros de consulta adicionales que se suministrarán desde las funciones del conector son

1. majorDimension : ROWS o COLUMNS decide cuál debe ser la matriz de datos interna
2. dateTimeRenderOption especifica el formato de los campos DateTime valor por defecto:FORMATTED_STRING
3. valueRenderOption especifica si los datos deben ser formateados o no en la respuesta valor por defecto:FORMATTED_VALUE

Extractor de salida

1. valueRanges: Se trata de una matriz de objetos. Cada objeto detalla un rango

Filtro Google Get Batch Data

Propósito

Este conector obtendrá los datos del spreadsheetId proporcionado dentro de la condición de filtro dada como un lote de datos. Los datos se suministrarán como una matriz de filas o columnas en función de los parámetros de consulta suministrados al conector.

Punto final

Llamada HTTP POST al punto final -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter

Entrada obligatoria

Los siguientes son los parámetros de consulta que deben pasarse

1. Id. de hoja de cálculo

Los parámetros adicionales del cuerpo de la solicitud que se suministrarán desde las funciones del conector son

1. Filtros de datos
2. majorDimension : ROWS o COLUMNS decide cuál debe ser la matriz de datos interna
3. dateTimeRenderOption especifica el formato de los campos DateTime valor por defecto:FORMATTED_STRING
4. valueRenderOption especifica si los datos deben ser formateados o no en la respuesta valor por defecto: FORMATTED_VALUE

Extractor de salida

1. valueRanges: Se trata de una matriz de objetos. Cada objeto detalla un rango

Vídeo