Connecteur Google Sheets

Connecteur Google Sheets

Introduction

L'API Google Sheets permet aux utilisateurs de créer, lire et éditer des feuilles de calcul Google avec les bons accès à leurs comptes Google. L'objectif de ce connecteur est de tirer parti de Tulip's Oauth 2.0 pour intégrer Google Sheets en utilisant des connecteurs HTTP et de fournir à nos clients un connecteur prêt à l'emploi qui peut être importé dans leur instance.

Objectif

1. Nous allons mettre en évidence les différentes fonctions du connecteur HTTP qui peuvent être construites en faisant des appels HTTP aux points d'extrémité de l'API (v4) de Google Sheets pour interagir avec la feuille de calcul Google afin d'essayer diverses actions de lecture et d'écriture sur la feuille de calcul qui pourraient être exploitées pour divers cas d'utilisation.

Doc API

1. Doc de référence de l'API Google Sheets

Conditions préalables

1. Créez un compte sur la console cloud de Google et configurez les informations d'identification OAuth 2.0. Plus d'informations peuvent être trouvées dans les documents API de Google.
2. Ajouter l'URL de redirection des instances sur la console cloud de Google

Détails de la connexion Tulip

Les informations suivantes doivent être configurées sur les connecteurs de Tulip.

1. Exécution : Hôte du connecteur cloud
2. Hôte:sheets.googleapis.com
3. Port:443
4. TLS : Oui
5. OAuth 2(Admin) : L'authentification sera transférée à toutes les fonctions du connecteur.

Fonctions de connexion

Nouvelle feuille de calcul Google

Objectif

1. Les utilisateurs peuvent passer un nom de feuille de calcul et un nom de feuille en entrée et Tulip créera une nouvelle feuille de calcul avec le nom de feuille fourni. La réponse de l'API sera les métadonnées et les diverses propriétés de la feuille de calcul, qui peuvent être utilisées comme filtres pour récupérer et mettre à jour les données des feuilles de calcul.
2. Les informations extraites de Google sheets V4 API peuvent ensuite être utilisées soit dans les applications Tulip, soit dans les tables Tulip, soit dans les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur.

Point d'arrivée

Appel HTTP POST au point de terminaison https://sheets.googleapis.com/v4/spreadsheets

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. Nom de la feuille de calcul - Titre de la feuille de calcul
2. Sheet Name - Titre initial de la feuille

Extracteur de sortie

1. feuille de calcul : Identifiant unique de la feuille de calcul qui sera utilisée pour effectuer les autres tâches
2. URL de la feuille de calcul : URL de la feuille de calcul nouvellement créée

Google - Obtenir les données d'une feuille de calcul

Objectif

Ce connecteur récupère les données de la feuille de calcul (spreadsheetId) fournie dans l'intervalle donné. Les données seront fournies sous la forme d'un tableau de lignes ou de colonnes en fonction des paramètres de requête fournis à la fonction du connecteur.

Point d'arrivée

Appel HTTP GET au point de terminaison -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

Données requises

Les paramètres URL à transmettre sont les suivants

1. ID de la feuille de calcul
2. Plage - Une chaîne au [format A1] (https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Les paramètres de requête supplémentaires qui seront fournis par les fonctions du connecteur sont les suivants

1. majorDimension : ROWS ou COLUMNS détermine la nature du tableau de données interne
2. dateTimeRenderOption spécifie le format des champs DateTime valeur par défaut:FORMATTED_STRING
3. valueRenderOption spécifie si les données doivent être formatées ou non dans la réponse valeur par défaut : FORMATTED_VALUE

Extracteur de sortie

1. Valeurs : Il s'agit d'un tableau de tableaux, chaque ligne de données étant un tableau.

Feuille de calcul Google InsertRow

Objectif

Ajoute des valeurs à une feuille de calcul. La plage d'entrée est utilisée pour rechercher des données existantes et trouver un "tableau" dans cette plage. Les valeurs seront ajoutées à la ligne suivante du tableau, en commençant par la première colonne du tableau. Le connecteur prend en compte spreadsheetId, Range et la liste des valeurs à insérer dans les cellules.

Point de terminaison

Appel HTTP POST au point de terminaison -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

Données requises

Les paramètres de requête à transmettre sont les suivants

1. ID de la feuille de calcul
2. Plage
3. Valeurs : pour ce connecteur, nous avons pris en compte 8 valeurs de colonne, chaque paramètre étant nommé en fonction de la colonne dans laquelle il sera inséré. Ces valeurs seront transmises à l'API sous la forme d'un tableau de valeurs.

Les paramètres de requête supplémentaires qui seront fournis par les fonctions du connecteur sont les suivants :

1. valueInputOption : Il s'agit d'un champ obligatoire qui sera envoyé par le connecteur : USER_ENTERED

Extracteur de sortie

1. spreadsheetId
2. UpdatedRows : Spécifie le nombre de lignes qui ont été insérées.

Effacement de la feuille de calcul Google

Objectif

Efface les valeurs d'une feuille de calcul. L'appelant doit spécifier l'ID de la feuille de calcul et la plage. Seules les valeurs sont effacées - toutes les autres propriétés de la cellule (telles que le formatage, la validation des données, etc.) sont conservées. Le connecteur prend en compte l'ID de la feuille de calcul, la plage et la liste des valeurs à insérer dans les cellules.

Point d'arrivée

HTTP POST appel au point de terminaison -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear

Données requises

Les paramètres de requête à transmettre sont les suivants

1. ID de la feuille de calcul
2. Plage

Google Get SpreadSheet Details byFilter (Obtenir les détails d'une feuille de calcul par filtre)

Objectif

Ce connecteur récupère les détails de la feuille de calcul avec l'ID de feuille de calcul fourni et les conditions spécifiques spécifiées dans le filtre de données.

Point de terminaison

Appel HTTP POST au point de terminaison -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter

Données requises

Les paramètres de requête à transmettre sont les suivants

1. spreadSheetId
2. includeGridData : La valeur par défaut est False

Les paramètres suivants sont envoyés dans le corps de la requête au format JSON

1. gridRange

Extracteurs de sortie

1. spreadSheetId
2. Titre
3. Locale
4. auto recalc
5. timeZone
6. sheetId
7. sheetTitle
8. sheetType
9. sheetRowCount
10. sheetColumnCount
11. spreadSheetUrl

D'autres paramètres peuvent être inclus dans la sortie en fonction du cas d'utilisation de l'utilisateur.

Obtention de données par lot par Google

Objectif

Ce connecteur récupère les données de la feuille de calcul (spreadsheetId) fournie dans le connecteur. Les données sont fournies sous la forme d'un tableau de lignes ou de colonnes en fonction des paramètres de requête fournis au connecteur.

Point d'arrivée

Appel HTTP GET au point de terminaison -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

Données requises

Les paramètres de requête à transmettre sont les suivants

1. ID de la feuille de calcul
2. Plage - Une chaîne dans [A1Format](https://developers.google.com/sheets/api/guides/concepts

a1_notation)

Les paramètres de requête supplémentaires qui seront fournis par les fonctions de connexion sont les suivants

1. majorDimension : ROWS ou COLUMNS détermine la nature du tableau de données interne
2. dateTimeRenderOption spécifie le format des champs DateTime valeur par défaut:FORMATTED_STRING
3. valueRenderOption spécifie si les données doivent être formatées ou non dans la réponse valeur par défaut:FORMATTED_VALUE

Extracteur de sortie

1. valueRanges : Il s'agit d'un tableau d'objets. Chaque objet détaille une plage

Filtre Google Get Batch Data

Objectif

Ce connecteur récupère les données de la feuille de calcul (spreadsheetId) fournie dans la condition de filtrage donnée sous forme de lot de données. Les données seront fournies sous forme de tableau de lignes ou de colonnes en fonction des paramètres de requête fournis au connecteur.

Point d'arrivée

HTTP POST appel au point de terminaison -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter

Données requises

Les paramètres de requête à transmettre sont les suivants

1. ID de la feuille de calcul

Les paramètres supplémentaires du corps de la requête qui seront fournis par les fonctions du connecteur sont les suivants

1. Filtres de données
2. majorDimension : ROWS ou COLUMNS décide de la nature du tableau de données interne
3. dateTimeRenderOption spécifie le format des champs DateTime valeur par défaut:FORMATTED_STRING
4. valueRenderOption spécifie si les données doivent être formatées ou non dans la réponse valeur par défaut : FORMATTED_VALUE

Extracteur de sortie

1. valueRanges : Il s'agit d'un tableau d'objets. Chaque objet détaille une plage

Vidéo