- Impression
:: : (info) () Pour télécharger l'application, visitez : Bibliothèque::: :
Intégration de Tulip avec l'API Google Drive v3
Introduction
L'API Google Drive permet aux utilisateurs de créer, lire et éditer des fichiers Google Drive avec les bons accès à leurs comptes Google. Le but de ce connecteur est d'utiliser l'authentification Oauth2.0 et d'intégrer l'API Google Drive V3 avec Tulip en utilisant des connecteurs HTTP et de fournir à nos clients un connecteur prêt à l'emploi qui peut être importé dans leur instance.
Objectif
- Nous allons mettre en évidence différentes fonctions de connecteur HTTP qui peuvent être construites en faisant des appels HTTP aux points d'extrémité de l'API Google Drive V3 pour interagir avec Google Drive et essayer diverses actions de lecture et d'écriture sur le disque qui pourraient être exploitées pour divers cas d'utilisation.
Doc API
Configuration de l'API Google
Comme pour beaucoup de connecteurs, la configuration en dehors de Tulip est la partie la plus difficile de l'intégration. Consultez ce guide vidéo qui décrit le processus de création d'un projet API Google, des informations d'identification et de leur intégration dans le plugin de bibliothèque Google Drive.
Conditions préalables
- Créez un compte sur la Cloud Console de Google et configurez les informations d'identification OAuth 2.0. Vous trouverez plus d'informations dans la documentation de l'API de Google.
- Activer l'API Google Drive dans la console API de Google.
Détails de la connexion Tulip
Les informations suivantes doivent être configurées sur les connecteurs de Tulip.
- Exécution sur : Cloud Connector Host
- Hôte: www.googleapis.com
- Port:443
- TLS : Oui
- Scopes qui doivent être configurés dans le connecteur :
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/drive.file
- https://www.googleapis.com/auth/drive.metadata
- https://www.googleapis.com/auth/drive.appdata
Fonctions du connecteur
Obtenir tous les fichiers du lecteur
Objectif
Ce connecteur permet de récupérer tous les fichiers existant dans le lecteur Google d'un utilisateur.
Point d'arrivée
Appel HTTP GET au point de terminaison https://www.googleapis.com:443/drive/v3/files?fields=*
Données requises
Aucune entrée requise
Sortie requise Extracteur
- File Id : Identifiant unique du fichier qui sera utilisé pour effectuer les autres tâches
- Nom du fichier : Nom du fichier
- Des paramètres supplémentaires renvoyés avec la réponse peuvent être inclus dans les paramètres de sortie.
Obtenir des métadonnées de fichiers spécifiques
Objectif
Ce connecteur permet de récupérer les métadonnées d'un fichier existant dans le lecteur.
Point d'arrivée
Appel HTTP GET au point de terminaison - https://www.googleapis.com:443/drive/v3/files/{FileID}?fields=*
Données requises
Les paramètres URL à transmettre sont les suivants
- Identifiant du fichier
Sortie requise Extracteur
- File Id : Identifiant unique du fichier qui sera utilisé pour effectuer les autres tâches.
- Nom du fichier : Nom du fichier
- Les paramètres supplémentaires renvoyés avec la réponse peuvent être inclus dans les paramètres de sortie.
Créer un nouveau fichier
Objectif
- Les utilisateurs peuvent transmettre un nom de fichier avec une extension de fichier et une description en entrée et Tulip créera un nouveau fichier avec le nom de fichier fourni. La réponse de l'API sera les métadonnées et les diverses propriétés du fichier.
- Les informations extraites de l'API Google Drive V3 peuvent ê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. Ces informations peuvent également être utilisées avec d'autres connecteurs Google.
Point d'arrivée
Appel HTTP POST au point de terminaison https://www.googleapis.com:443/drive/v3/files Entrée requise
Données requises
Les paramètres suivants sont envoyés dans le corps de la requête
- Nom du fichier - Titre du fichier avec son extension
- Description - Description du fichier
Extracteur de sortie requis
- File Id : Identifiant unique du fichier qui sera utilisé pour effectuer les autres tâches.
- Nom du fichier : Nom du fichier : nom du fichier
- Des paramètres supplémentaires renvoyés avec la réponse peuvent être inclus dans les paramètres de sortie.
Supprimer le fichier
Objectif
- Les utilisateurs peuvent transmettre l'ID du fichier en entrée et Tulip supprimera le fichier dans le lecteur.
Point final
Appel HTTP DELETE au point de terminaison - https://www.googleapis.com:443/drive/v3/files
Données requises
Les paramètres suivants sont envoyés dans le corps de la requête
- ID du fichier
Extracteur de sortie requis
Aucune sortie n'est extraite car la réponse est vide.