MENU
    Connecteur Google Sheets
    • 03 Nov 2023
    • 6 Minutes à lire
    • Contributeurs

    Connecteur Google Sheets


    Résumé de l’article

    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


    Cet article vous a-t-il été utile ?