Zum Inhalt springen

Google Drive-Connector in Jitterbit Studio

Zusammenfassung

Der Google Drive-Connector stellt Zugriff auf Google Drive her.

Der Google Drive-Connector bietet eine Schnittstelle zum Erstellen einer Google Drive-Verbindung, die Grundlage für die Generierung von Instanzen von Google Drive-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Google Drive.

Der Google Drive-Connector wird über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Google Drive-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte Google Drive-Verbindung und ihre Aktivitäten als Google Drive-Endpunkt bezeichnet:

Google Drive-Aktivitätstypen

  • Datei aktualisieren: Aktualisiert Dateien in Google Drive und soll als Ziel in einem Vorgang verwendet werden.

  • Datei löschen: Löscht eine Datei aus Google Drive und soll als Ziel in einem Vorgang verwendet werden.

  • Datei erstellen: Erstellt Dateien in Google Drive und soll als Ziel in einem Vorgang verwendet werden.

  • Dateien auflisten: Ruft eine Liste von Dateien (die einer Abfrage entsprechen) aus Google Drive ab und soll als Quelle in einem Vorgang verwendet werden.

  • Datei abrufen: Ruft eine Datei aus Google Drive ab und soll als Quelle in einem Vorgang verwendet werden.

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren aussetzen.

Der Google Drive-Connector verwendet die Google Drive API v3. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Um die 3-beinige OAuth 2.0 (3LO)-Authentifizierung oder die Authentifizierung mit Google Cloud-Dienstkonto mit dem Google Drive-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Agent-Version 10.83 / 11.21 oder später ist erforderlich, um 3LO zu verwenden.

Um den Google Drive-Connector ohne 3LO zu verwenden, benötigen Sie ein Google-Dienstkonto für Ihr Projekt mit entsprechend festgelegten Berechtigungen und bestimmte Anmeldedaten aus dem Dienstkonto, wie unter Google Drive-Voraussetzungen beschrieben.

Hinweis

Der Google Drive-Ordner, auf den Sie zugreifen möchten, muss mit dem Google-Dienstkonto geteilt werden, das in der Verbindung verwendet wird. Auf Dokumente außerhalb des freigegebenen Ordners kann nicht zugegriffen werden.

Einschränkungen des Google-Dienstkontos

Aufgrund einer Einschränkung bei der Verwendung von Google-Dienstkonten (die keinen Zugriff auf alle Google Drive-Optionen haben), kann die Google Drive-Aktivität Dateien auflisten möglicherweise keine vollständige Dateiliste zurückgeben.

Fehlerbehebung

Falls Probleme mit dem Google Drive-Connector auftreten, werden diese Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird).

  2. Überprüfen Sie die Operationsprotokolle auf alle während der Ausführung der Operation geschriebenen Informationen.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agents können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agents einfügen:

    <logger name="org.jitterbit.connector.drive.verbose.logging.drive.VerboseLoggerManager" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.

  5. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.