Google Drive Connector

Integration von Tulip mit Google Drive v3 API

Einführung

Google Drive API ermöglicht den Benutzern das Erstellen, Lesen und Bearbeiten von Google Drive-Dateien mit den richtigen Zugriffsrechten für ihre Google-Konten. Das Ziel dieses Konnektors ist es, die Oauth2.0-Authentifizierung zu verwenden und Google Drive V3 API mit Tulip über HTTP-Konnektoren zu integrieren und unseren Kunden einen fertigen Konnektor zu bieten, der in ihre Instanz importiert werden kann.

Zweck

1. Wir werden verschiedene HTTP-Connector-Funktionen hervorheben, die durch HTTP-Aufrufe an Google Drive V3 API-Endpunkte erstellt werden können, um mit Google Drive zu interagieren und verschiedene Lese- und Schreibaktionen auf dem Laufwerk auszuprobieren, die für verschiedene Anwendungsfälle genutzt werden können.

API-Dokument

Google Drive-API-Doku

Google API-Einrichtung

Wie bei vielen Konnektoren ist die Einrichtung außerhalb von Tulip der schwierigste Teil der Integration. Schauen Sie sich diese Videoanleitung an, die Sie durch den Prozess der Erstellung eines Google API-Projekts und der Anmeldeinformationen führt und sie in das Google Drive Library Plugin bringt.

Vorraussetzungen

1. Erstellen Sie ein Konto in der Google Cloud Console und konfigurieren Sie die OAuth 2.0-Anmeldeinformationen. Weitere Informationen finden Sie in den API-Dokumenten von Google.
2. Aktivieren Sie die Google Drive API in der Google API-Konsole.

Tulip Verbindungsdetails

Die folgenden Informationen müssen für die Tulip-Konnektoren konfiguriert werden.

1. Läuft auf: Cloud Connector Host
2. Rechner:www.googleapis.com
3. Anschluss:443
4. TLS: Ja
5. Bereiche, die im Konnektor konfiguriert werden müssen:
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

Konnektor-Funktionen

Alle Laufwerksdateien abrufen

Zweck

Dieser Connector ruft alle Dateien ab, die im Google Drive eines Benutzers vorhanden sind.

Endpunkt

HTTP GET-Aufruf an den Endpunkt https://www.googleapis.com:443/drive/v3/files?fields=*

Erforderliche Eingabe

Keine Eingaben erforderlich

Erforderlicher Output Extraktor

1. Datei Id: Eindeutige Kennung der Datei, die für die Ausführung der anderen Aufgaben verwendet wird
2. Dateiname: Der Dateiname der Datei
3. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden

Spezifische Datei-Metadaten abrufen

Zweck

Dieser Konnektor ruft die Metadaten einer im Laufwerk vorhandenen Datei ab.

Endpunkt

HTTP GET-Aufruf an den Endpunkt - https://www.googleapis.com:443/drive/v3/files/{FileID}?fields=*

Erforderliche Eingabe

Die folgenden URL-Parameter sind zu übergeben

1. Datei-ID

Erforderlicher Output Extraktor

1. Datei-Id: Eindeutige Kennung der Datei, die für die Ausführung der anderen Aufgaben verwendet wird
2. Dateiname: Der Dateiname der Datei
3. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden

Neue Datei erstellen

Zweck

1. Benutzer können einen Dateinamen mit Dateierweiterung und Beschreibung als Eingabe übergeben & Tulip wird eine neue Datei mit dem angegebenen Dateinamen erstellen. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften der Datei.
2. Die Informationen, die von der Google Drive V3 API abgerufen werden, können entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen eingefügt werden. Diese Informationen können auch mit anderen Google-Konnektoren verwendet werden.

Endpunkt

HTTP POST-Aufruf an den Endpunkt https://www.googleapis.com:443/drive/v3/files Erforderliche Eingabe

Erforderliche Eingaben

Die folgenden Parameter werden als Request Body gesendet

1. File Name - Der Dateititel mit Erweiterung
2. Beschreibung - Beschreibung der Datei

Erforderlicher Output-Extraktor

1. Datei Id: Eindeutiger Bezeichner der Datei, der für die Ausführung der anderen Aufgaben verwendet wird
2. Dateiname: Der Dateiname der Datei
3. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden

Datei löschen

Zweck

1. Benutzer können die Datei-ID als Eingabe übergeben und Tulip wird die Datei im Laufwerk löschen.

Endpunkt

HTTP DELETE Aufruf an den Endpunkt - https://www.googleapis.com:443/drive/v3/files

Erforderliche Eingaben

Die folgenden Parameter werden als Body der Anfrage gesendet

1. Datei-ID

Erforderliche Ausgabe Extraktor

Es werden keine Ausgaben extrahiert, da es eine leere Antwort zurückgibt.