Connecteur Google Drive

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

1. 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

Doc API Google Drive

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

1. 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.
2. 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.

1. Exécution sur : Cloud Connector Host
2. Hôte: www.googleapis.com
3. Port:443
4. TLS : Oui
5. Scopes qui doivent être configurés dans le connecteur :
6. https://www.googleapis.com/auth/drive
7. https://www.googleapis.com/auth/drive.file
8. https://www.googleapis.com/auth/drive.metadata
9. https://www.googleapis.com/auth/drive.appdata

Fonctions du connecteur

Obtenir tous les fichiers du lecteur

Objectif

Ce connecteur récupère 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

1. File Id : Identifiant unique du fichier qui sera utilisé pour effectuer les autres tâches
2. Nom du fichier : Nom du fichier
3. 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 spécifiques à un fichier

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

1. Identifiant du fichier

Sortie requise Extracteur

1. File Id : Identifiant unique du fichier qui sera utilisé pour effectuer les autres tâches.
2. Nom du fichier : Nom du fichier
3. 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

1. 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.
2. 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

1. Nom du fichier - Titre du fichier avec son extension
2. Description - Description du fichier

Extracteur de sortie requis

1. File Id : Identifiant unique du fichier qui sera utilisé pour effectuer les autres tâches.
2. Nom du fichier : Nom du fichier : nom du fichier
3. Des paramètres supplémentaires renvoyés avec la réponse peuvent être inclus dans les paramètres de sortie.

Supprimer le fichier

Objectif

1. 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

1. ID du fichier

Extracteur de sortie requis

Aucune sortie n'est extraite car la réponse est vide.