Google Drive-Verbindung erstellen und konfigurieren

Auf dieser Seite wird beschrieben, wie Sie eine Google Drive-Verbindung in Integration Connectors erstellen und konfigurieren. Weitere Informationen zum Google Drive-Connector finden Sie unter Google Drive-Connector – Übersicht.

Hinweise

Führen Sie in Ihrem Google Cloud-Projekt die folgenden Aufgaben aus:

  • Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Informationen zu Netzwerkmustern finden Sie unter Netzwerkverbindung.
  • Weisen Sie dem Nutzer, der den Connector konfiguriert, die IAM-Rolle roles/connectors.admin zu.
  • Weisen Sie dem Dienstkonto, das Sie für den Connector verwenden möchten, die IAM-Rollen roles/secretmanager.viewer und roles/secretmanager.secretAccessor zu.
  • Aktivieren Sie die folgenden Dienste:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    Informationen zum Aktivieren von Diensten finden Sie unter Dienste aktivieren. Wenn diese Dienste oder Berechtigungen für Ihr Projekt zuvor nicht aktiviert wurden, werden Sie aufgefordert, sie beim Konfigurieren des Connectors zu aktivieren.

Google Drive-Verbindung erstellen

So erstellen Sie eine Google Drive-Verbindung:

  1. Rufen Sie in der Google Cloud Console die Seite Integration Connectors > Verbindungen auf.

    Zu „Verbindungen“

  2. Klicken Sie auf  Verbindung erstellen.

    Die Seite Verbindung erstellen wird angezeigt.

  3. Im Abschnitt Standort:
    1. Klicken Sie auf Region und wählen Sie einen Standort für Ihre Verbindung aus.

      Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

    2. Klicken Sie auf Weiter.
  4. Geben Sie im Abschnitt Verbindungsdetails die folgenden Details an:
    1. Connector: Wählen Sie Google Drive aus.
    2. Connector-Version: Wählen Sie die Version des Connectors aus, die Sie verwenden möchten.

      Die von Ihnen ausgewählte Connector-Version hängt von der Google Drive API-Version ab, die Sie verwenden möchten. Weitere Informationen finden Sie unter Google Drive-Verbindungsversionen.

    3. Verbindungsname: Geben Sie einen Namen für die Verbindung ein.
    4. Beschreibung: Geben Sie optional eine Beschreibung für die Verbindung ein.
    5. Optional können Sie Cloud Logging aktivieren und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error festgelegt.
    6. Dienstkonto: Wählen Sie das Dienstkonto aus, das Sie für die Verbindung verwenden möchten. Prüfen Sie, ob das Dienstkonto die erforderlichen IAM-Rollen und -Berechtigungen hat.
    7. Unterstützt alle Laufwerke: Aktivieren Sie dieses Kästchen, um den Zugriff auf geteilte Ablagen zu ermöglichen. Diese Option ist nur für Google Drive v2 verfügbar.
    8. Verbindungsknoteneinstellungen: Konfigurieren Sie optional die Verbindungsknoteneinstellungen.
      • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
      • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

      Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

    9. Klicken Sie auf Weiter.
  5. Wählen Sie im Bereich Authentifizierung den Authentifizierungstyp für die Verbindung aus und konfigurieren Sie ihn:

    Dienstkonto

    Wählen Sie diese Option aus, wenn Ihre Anwendung auf einer Google Cloud-VM ausgeführt wird und das angehängte Dienstkonto der VM zur Authentifizierung verwendet werden soll.

    Wenn Sie diesen Authentifizierungstyp verwenden möchten, benötigen Sie ein Dienstkonto mit den entsprechenden IAM-Rollen und -Berechtigungen, die für die Authentifizierung erforderlich sind.

    Informationen zum Erstellen eines Dienstkontos finden Sie unter Dienstkonten erstellen und verwalten. Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.

    Beispiel für Verbindungsdetails für den Authentifizierungstyp „Dienstkonto“

    Feldname Details
    Standort us-central1
    Connector Google Drive
    Connector-Version 2
    Verbindungsname googledrive-ws-gcpaccount
    Cloud Logging aktivieren Ja
    Dienstkonto 123456789012-compute@developer.gserviceaccount.com
    Mindestanzahl von Knoten 2
    Maximale Anzahl von Knoten 50
    Authentifizierung Dienstkonto-Authentifizierung

    OAuth 2.0 – JWT-Inhaber

    So konfigurieren Sie den Authentifizierungstyp „OAuth 2.0 – JWT-Inhaber“:

    1. Erstellen Sie einen JSON-Schlüssel für das Dienstkonto und laden Sie die JSON-Schlüsseldatei herunter. Diese Schlüsseldatei wird als JWT-Zertifikat für die Verbindung verwendet.
    2. Erstellen Sie ein Secret, um die JSON-Schlüsseldatei oder das JWT-Zertifikat zu speichern.
    3. Geben Sie die Secret-Details an, wenn Sie die Verbindung in Integration Connectors erstellen:
      • JWT-Zertifikat: Wählen Sie das Secret mit dem JWT-Zertifikat aus.
      • Secret-Version: Wählen Sie die Secret-Version für das ausgewählte Secret aus.
      • JWT-Betreff: (Optional) Geben Sie den JWT-Betreff ein, der für die Verbindung verwendet werden soll. Dies wird als Feld sub im JWT-Token verwendet.

    Beispiel für Verbindungsdetails für den Authentifizierungstyp „OAuth 2.0 – JWT-Inhaber“

    Feldname Details
    Standort us-central1
    Connector Google Drive
    Connector-Version 2
    Verbindungsname googledrivejwt
    Cloud Logging aktivieren Ja
    Dienstkonto 123456789012-compute@developer.gserviceaccount.com
    Mindestanzahl von Knoten 2
    Maximale Anzahl von Knoten 50
    Authentifizierung OAuth 2.0 – JWT-Inhaber
    JWT-Zertifikat 
    {
  "type": "service_account",
  "project_id": "sm****-****-******",
  "private_key_id": "0b***************************",
  "private_key": "-----BEGIN PRIVATE KEY-----\nO********************************************=\n-----END PRIVATE KEY-----\n",
  "client_email": "go**********************************8",
  "client_id": "10**********************",
  "auth_uri": "https:***********************",
  "token_uri": "https:************************",
  "auth_provider_x509_cert_url": "https:*********************",
  "client_x509_cert_url": "https:****************************************************",
  "universe_domain": "go********"
}
    Secret-Version 2

    Oauth 2.0-Autorisierungscode

    Verwenden Sie diese Methode, wenn Ihre Anwendung eine Endnutzerinteraktion über eine browserbasierte Anmeldung erfordert.

    So konfigurieren Sie den Authentifizierungstyp „OAuth 2.0-Autorisierungscode“:

    1. Erstellen Sie OAuth 2.0-Anmeldedaten für Ihre Webanwendung. Bei diesem Vorgang werden eine Client-ID und die JSON-Datei mit dem Clientschlüssel erstellt.
    2. Zugriffsbereiche identifizieren, die Sie Ihrer Anwendung gewähren möchten.
    3. Erstellen Sie einen Secret, um die OAuth 2.0-Anmeldedaten (client_secret.json) zu speichern.
    4. Geben Sie die Client-ID, die Bereiche und die Secret-Details an, wenn Sie die Verbindung in Integration Connectors erstellen:
      • Client-ID: Geben Sie die Client-ID ein, die für Ihre Webanwendung erstellt wurde.
      • Bereiche: Geben Sie eine durch Kommas getrennte Liste der gewünschten Bereiche ein.
      • Clientschlüssel: Wählen Sie das Secret mit den OAuth 2.0-Anmeldedaten aus.
      • Secret-Version: Wählen Sie die Secret-Version für das ausgewählte Secret aus.

    Beispieldetails für die Verbindung für den Authentifizierungstyp „OAuth 2.0-Autorisierungscode“

    Feldname Details
    Standort europe-west1
    Connector Google Drive
    Connector-Version 2
    Verbindungsname googledrive-wsconn-code
    Cloud Logging aktivieren Ja
    Dienstkonto 123456789012-compute@developer.gserviceaccount.com
    Mindestanzahl von Knoten 2
    Maximale Anzahl von Knoten 50
    Authentifizierung OAuth 2.0-Autorisierungscode
    Client-ID CLIENT_ID
    Bereiche https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/drive.appdata, https://www.googleapis.com/auth/drive.appfolder, https://www.googleapis.com/auth/drive.install, https://www.googleapis.com/auth/drive.metadata, https://www.googleapis.com/auth/drive.metadata.readonly, https://www.googleapis.com/auth/drive.activity, https://www.googleapis.com/auth/drive.activity.readonly, https://www.googleapis.com/auth/drive.apps.readonly, https://www.googleapis.com/auth/drive.scripts und https://www.googleapis.com/auth/drive.meet.readonly
    Clientschlüssel CLIENT_SECRET
    Secret-Version 2
  6. Authentifizierungsüberschreibung aktivieren: Optional. Wählen Sie dieses Kästchen aus, damit für die Verbindung während der Laufzeit dynamisch eine andere Authentifizierung akzeptiert werden kann.
  7. Klicken Sie auf Weiter.
  8. Prüfen Sie im Abschnitt Überprüfen Ihre Verbindungs- und Authentifizierungsdetails. Sie können jederzeit auf einen der vorherigen Abschnitte klicken, um bei Bedarf Änderungen vorzunehmen.
  9. Klicken Sie auf Erstellen.

    Integration Connectors beginnt mit dem Erstellen der Verbindung für die angegebene Konfiguration. Dieser Vorgang dauert einige Minuten. Nachdem die Verbindung erstellt wurde, werden Sie zur Seite Connections (Verbindungen) weitergeleitet.

Google Drive-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie sowohl in Apigee Integration als auch in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Aufgabe „Connectors“ verwenden.

  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Apigee Integration finden Sie unter Connectors-Aufgabe.
  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Application Integration finden Sie unter Connectors-Aufgabe.

Eine Liste der unterstützten Entitäten und Vorgänge finden Sie unter Unterstützte Entitäten und Vorgänge. Informationen zu den unterstützten connectorspezifischen Aktionen finden Sie unter Unterstützte Aktionen.

Anwendungsbeispiele in Application Integration

Die folgenden Beispiele veranschaulichen, wie Sie die Connectors-Aufgabe in Application Integration verwenden, um Vorgänge mit Ihrer konfigurierten Google Drive-Verbindung auszuführen.

Beispiel: Alle Dateien auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Files aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
  4. Im Bereich Aufgabeneingabe der Aufgabe Connectors können Sie die filterClause gemäß den Kundenanforderungen festlegen.

    5. Der Wert für filterClause sollte immer in einfachen Anführungszeichen (') in diesem Format übergeben werden.

    Mit dem filterClause können Sie bestimmte Datensätze anhand beliebiger Spalten filtern.

Beispiel: Dateidetails abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Files aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
  4. Legen Sie die entityId auf „1wsHFAusizqFe5O2“ fest. Das ist der Schlüssel, der übergeben werden soll. Klicken Sie zum Festlegen der entityId im Bereich Data Mapper von Data Mapping auf Open Data Mapping Editor (Datenabgleichs-Editor öffnen), geben Sie "1wsHFAusizqFe5O2" in das Feld Input Value (Eingabewert) ein und wählen Sie „entityId“ als lokale Variable aus.

    5. Der Wert für entityId muss direkt übergeben werden, z. B. „1wsHFAusizqFe5O2“. „1wsHFAusizqFe5O2“ ist hier der eindeutige Primärschlüsselwert, der übergeben wird.

Beispiel: Datei löschen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Files aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
  4. Setzen Sie die entityId auf „1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L“. Dies ist der Schlüssel, der übergeben werden muss. Klicken Sie zum Festlegen der entityId im Bereich Data Mapper von Data Mapping auf Open Data Mapping Editor (Datenabgleichs-Editor öffnen), geben Sie "1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L" in das Feld Input Value (Eingabewert) ein und wählen Sie „entityId“ als lokale Variable aus.

    5. Wenn die Entität zwei zusammengesetzte Geschäfts- oder Primärschlüssel hat, können Sie anstelle der entityId auch die filterClause auf id='1nLrFkDM8nOehXwW8XEpc2UZDBrq_ku-L' festlegen.

Beispiel: Datei erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Files aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „entityId“/„connectorInputPayload“ als lokale Variable aus.
    5.   { "FileData": " ",
  "Name": "creategcpshareddrivedocxfile.docx", 
  "MIMEType": "application/vnd.google-apps.document",
  "Encoding": "BASE64"}

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    { "Id": "1C48uLda6lyeakx2hOUdwnib-qtFOAhlpR_Ja2AmPvTU"}

Beispiel: Geteilte Ablage erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Drives aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „entityId“/„connectorInputPayload“ als lokale Variable aus.
    5.   {"Name": "SharedDrive7"}

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

      {"Id": "0AN6y5wEvVrmPUk9PVA"}

Beispiel: Berechtigung für eine Datei, einen Ordner oder eine geteilte Ablage erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Permissions aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „entityId“/„connectorInputPayload“ als lokale Variable aus.
    5.   {"ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L",
  "Role": "COMMENTER",
  "Type": "USER",
  "EmailAddress": "charlie@altostrat.com"}

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

      { "PermissionId": "10596783046483894074",
  "ResourceId": "1PErCmc9MmnYzcslo49DeIIN1-ACs3W4L"}

Beispiel: Dateidetails aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Files aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „entityId“/„connectorInputPayload“/„filterClause“ als lokale Variable aus. 
      {"Name": "New Updated file"}
  5. Legen Sie die entityId der Datei fest. Klicken Sie zum Festlegen der entityId auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „entityId/connectorInputPayload/filterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf 1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm festlegen.

    6. Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

    {"Id": "1IY5YhQN-LRgR3IxKlheqXM83sJP3DMFm">}

Beispiel: Berechtigung für eine Datei, einen Ordner oder eine geteilte Ablage aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Permissions aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „entityId“/„connectorInputPayload“/„filterClause“ als lokale Variable aus.
    5. (PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA')
{ "Role": "READER"}
  5. Legen Sie die „entityId“ der Berechtigung fest. Klicken Sie zum Festlegen der entityId auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „entityId/connectorInputPayload/filterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf PermissionId='10596783046483894074' and ResourceId='0AKfRSSy6kZbfUk9PVA' festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

      {"PermissionId": "10596783046483894074",
  "ResourceId": "0AKfRSSy6kZbfUk9PVA"}