Google Drive csatlakozó

Tulip integrálása a Google Drive v3 API-val

Bevezetés

A Google Drive API lehetővé teszi a felhasználók számára, hogy létrehozzák, olvassák és szerkesszék a Google Drive fájlokat a Google-fiókjukhoz beállított megfelelő hozzáféréssel. Ennek a csatlakozónak a célja az Oauth2.0 hitelesítés használata és integrálása a Google Drive V3 API-val a Tulipba HTTP csatlakozók segítségével, és ügyfeleink számára egy olyan out-of-box csatlakozót biztosít, amelyet be lehet importálni a példányukba.

Cél

1. Különböző HTTP-csatlakozó funkciókat fogunk kiemelni, amelyek a Google Drive V3 API végpontok HTTP-hívásaival építhetők a Google Drive-val való interakcióhoz, hogy kipróbálhassuk a meghajtón a különböző olvasási és írási műveleteket, amelyeket különböző felhasználási esetekben lehet kihasználni.

API-dokumentum

Google Drive API-dokumentum

Google API beállítása

Mint sok más csatlakozó esetében, a Tulipen kívüli beállítás a legnehezebb része az integrálásnak. Tekintse meg ezt a videó útmutatót, amely végigvezet a Google API projekt létrehozásának folyamatán, a hitelesítő adatokon és ezek bevitelén a Google Drive Library Pluginbe.

Előfeltételek

1. Hozzon létre egy fiókot a Google felhő konzolján és konfigurálja az OAuth 2.0 hitelesítő adatokat. További információ a Google API dokumentációjában található.
2. Aktiválja a Google Drive API-t a Google API konzolban.

Tulip kapcsolat részletei

A következő információkat kellene konfigurálni a Tulip csatlakozókon.

1. Futtatás: Cloud Connector Host
2. Host:www.googleapis.com
3. Port:443
4. TLS: Igen
5. A csatlakozóban konfigurálandó hatókörök:
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

A csatlakozó funkciói

Minden meghajtófájl lekérdezése

Cél

Ez a csatlakozó lekérdezi a felhasználó google meghajtóján található összes fájlt.

Végpont

HTTP GET hívás a https://www.googleapis.com:443/drive/v3/files?fields=* végpontra.

Kötelező bemenet

Nincs szükség bemenetre

Kötelező kimenet Extractor

1. Fájl azonosító: A fájl egyedi azonosítója, amelyet a többi feladat végrehajtásához használnak.
2. Fájlnév: A fájl neve
3. A válasszal együtt visszaküldött további paraméterek a kimeneti paraméterek részeként szerepelhetnek.

Speciális fájlmetaadatok lekérdezése

Cél

Ez a csatlakozó lekérdezi a meghajtóban létező fájl metaadatait.

Végpont

HTTP GET hívás a végponthoz - https://www.googleapis.com:443/drive/v3/files/{FileID}?fields=*

Kötelező bemenet

A következő URL paramétereket kell átadni

1. Fájl azonosító

Kötelező kimenet Extractor

1. File Id: A fájl egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak.
2. Fájlnév: A fájl neve
3. A válasszal együtt visszaküldött további paraméterek a kimeneti paraméterek részeként szerepelhetnek.

Új fájl létrehozása

Cél

1. A felhasználók átadhatnak egy fájlnevet a fájlkiterjesztéssel és a leírással együtt bemenetként, és a Tulip létrehoz egy új fájlt a megadott fájlnévvel. Az API válasza a fájl metaadatai és különböző tulajdonságai lesznek.
2. A Google Drive V3 API-ból származó információk tovább használhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozófüggvényekbe továbbítanak. Ezek az információk más Google-konnektorokkal is felhasználhatók.

Végpont

HTTP POST hívás a https://www.googleapis.com:443/drive/v3/files végpontra Kötelező bemenet

Kötelező bemenet

A következő paraméterek a kérés testeként elküldött paraméterek

1. Fájlnév - A fájl címe a kiterjesztéssel
2. Leírás - A fájl leírása

Kötelező kimenet Extractor

1. Fájl azonosító: A fájl egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak.
2. Fájlnév: A fájl neve
3. A válasszal együtt visszaküldött további paraméterek a kimeneti paraméterek részeként szerepelhetnek.

Fájl törlése

Cél

1. A felhasználók megadhatják a Fájl azonosítót bemenetként, és a Tulip törli a fájlt a meghajtón.

Végpont

HTTP DELETE hívás a végponthoz - https://www.googleapis.com:443/drive/v3/files

Szükséges bemenet

A következő paraméterek a kérés testeként elküldött paraméterek

1. Fájl azonosító

Kötelező kimenet Extractor

Nincs kimeneti kivonat, mivel üres választ ad vissza.