Zum Inhalt springen

Google Drive-Connector für Jitterbit Studio

Zusammenfassung

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

Der Google Drive-Connector bietet eine Schnittstelle zur Erstellung einer Google Drive-Verbindung, die als Grundlage für die Generierung von Instanzen von Google Drive-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Google Drive.

Der Google Drive-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Google Drive-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

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

Google Drive-Aktivitätstypen

  • Datei aktualisieren: Aktualisiert Dateien in Google Drive und ist als Ziel in einem Vorgang gedacht.

  • Datei löschen: Löscht eine Datei aus Google Drive und ist als Ziel in einem Vorgang gedacht.

  • Datei erstellen: Erstellt Dateien in Google Drive und ist als Ziel in einem Vorgang gedacht.

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

  • Datei abrufen: Ruft eine Datei von Google Drive ab und ist als Quelle in einem Vorgang vorgesehen.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Google Drive-Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

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

Um die 3-beinige OAuth 2.0 (3LO)-Authentifizierung oder die Authentifizierung mit einem Google Cloud-Dienstkonto mit dem Google Drive-Connector zu verwenden, sind zusätzliche Voraussetzungen erforderlich. Für die Verwendung von 3LO ist die Agentenversion 10.83 / 11.21 oder höher erforderlich.

Um den Google Drive-Connector ohne 3LO zu verwenden, müssen Sie ein Google-Dienstkonto für Ihr Projekt mit den entsprechenden Berechtigungen einrichten und bestimmte Anmeldeinformationen vom Dienstkonto erhalten, wie in den Voraussetzungen für Google Drive 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. Dokumente außerhalb des freigegebenen Ordners können nicht zugegriffen werden.

Google-Dienstkonto-Einschränkungen

Aufgrund einer Einschränkung bei der Verwendung von Google-Dienstkonto-Anmeldeinformationen (die nicht auf alle Google Drive-Optionen zugreifen können), gibt die Google Drive Dateien auflisten-Aktivität möglicherweise keine vollständige Liste von Dateien zurück.

Fehlersuche

Wenn Sie Probleme mit dem Google Drive-Connector haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

  1. Klicken Sie auf die Test-Schaltfläche in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationseinstellung Automatische Connector-Aktualisierung deaktivieren).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie das Debug-Protokoll für den Vorgang (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokollieren des Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

    Weitere Informationen zum ausführlichen Protokollieren von Connectors finden Sie unter Ausführliches Protokollieren für Connectors, die Jitterbit private Agenten verwenden.

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.

  6. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlersuche bei Operationen.