Google Drive Connector

Mit dem Google Drive-Connector können Sie eine Google Drive-Verbindung in Integration Connectors erstellen und konfigurieren. Sie können diese Verbindung in Ihren Geschäftsanwendungen verwenden, um Daten sicher auszutauschen und Vorgänge mit Google Drive auszuführen.

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.

Google Drive-Connector-Versionen

Der Google Drive-Connector unterstützt zwei Versionen:

  • Google Drive v1: Mit dieser Connector-Version können Sie auf die Google Drive API v3 zugreifen.
  • Google Drive v2: Mit dieser Connector-Version können Sie auf die Google Drive v2 API zugreifen.

Informationen zum Erstellen einer Google Drive-Verbindung finden Sie unter Google Drive-Connector erstellen und konfigurieren.

Unterstützte Entitäten und Vorgänge

Der Google Drive-Connector unterstützt die folgenden Entitäten und Vorgänge:

Entität Beschreibung Vorgänge
File Stellt eine Datei in Google Drive dar. Get: List, Create, Update, Delete
Folder Stellt einen Ordner in Google Drive dar. Get: List, Create, Update, Delete
Permission Stellt eine Berechtigung für eine Datei oder einen Ordner in Google Drive dar. Get: List, Create, Update, Delete
Drive Stellt ein Laufwerk in Google Drive dar. Get: List, Create, Update, Delete

Beispiele für Anwendungsfälle für Application Integration finden Sie unter Beispiele für Anwendungsfälle in Application Integration.

Unterstützte Aktionen

Der Google Drive-Connector unterstützt die folgenden Aktionen:

CopyResource
Beschreibung: Erstellt eine Kopie einer angegebenen Ressource in Google Drive. Sie können einen neuen Namen für die kopierte Datei definieren und den Zielordner angeben, indem Sie eine Liste mit IDs des übergeordneten Ordners angeben .

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID der zu kopierenden Ressource.
NewName String Ja Der neue Name der kopierten Datei.
ParentIDs String Nein Eine durch Kommas getrennte Liste von IDs der übergeordneten Ordner, in denen die kopierte Datei platziert wird. Wenn nichts angegeben ist, wird die Datei in denselben Ordner kopiert, in dem sie sich befand.
IgnoreDefaultVisibility Boolesch Nein Gibt an, ob die Standardeinstellungen für die Sichtbarkeit für die neu erstellte Datei umgangen werden sollen. Wenn die Domain so konfiguriert ist, dass alle hochgeladenen Dateien standardmäßig sichtbar sind, wird dieses Verhalten durch das Festlegen dieses Parameters auf „true“ für diese spezielle Anfrage überschrieben.

Der Standardwert ist „false“.

IncludeLabels String Nein Eine durch Kommas getrennte Liste mit IDs von Labels, die im Teil „labelInfo“ der Antwort enthalten sein sollen.
IncludePermissionsForView String Ja In diesem Feld wird angegeben, welche zusätzlichen Berechtigungen für Ansichten in die Antwort aufgenommen werden sollen. Der unterstützte Wert wird veröffentlicht.
KeepRevisionForever Boolesch Nein Gibt an, ob die Überarbeitungen der Datei dauerhaft beibehalten werden sollen.

Diese Funktion gilt nur für Dateien mit binären Inhalten in Google Drive. Pro Datei können maximal 200 Revisionen dauerhaft gespeichert werden. Wenn das Limit erreicht ist, müssen Sie vorhandene Überarbeitungen löschen, um neue hinzuzufügen. Der Standardwert ist „false“.

OCRLanguage String Nein Dieses Feld enthält einen Sprachhinweis für die OCR (optische Zeichenerkennung) beim Importieren von Bilddateien.

Geben Sie die Sprache mit einem zweistelligen ISO 639-1-Sprachcode an, z. B. en für Englisch und de für Deutsch.

SupportsAllDrives Boolesch Ja Dieser Parameter gibt an, ob Änderungen in „Meine Ablage“ und in geteilten Ablagen nachverfolgt werden sollen.

Setzen Sie diesen Parameter auf „true“, um den Zugriff auf geteilte Ablagen zu aktivieren. Der Standardwert ist „false“.

Ausgabeparameter

Parametername Datentyp Beschreibung
CopiedFileID String Die ID der kopierten Datei.
Success String Dieser Parameter gibt an, ob der Vorgang erfolgreich war.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion CopyResource in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion CopyResource aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Default Value ein:
            { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
          

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

            [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]
          

CreateFolder
Beschreibung: Erstellt einen neuen Ordner in Google Drive. Sie müssen einen Namen für den neuen Ordner angeben und seinen Speicherort festlegen, indem Sie die IDs der übergeordneten Ordner angeben. Sie können auch eine optionale Beschreibung hinzufügen und den Ordner mit einem Sternchen markieren.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Name String Ja Der Titel des Ordners.
Description String Nein Die Beschreibung des Ordners.
Starred Boolesch Nein Dieser Parameter gibt an, ob der Ordner mit einem Sternchen markiert ist.

Der Standardwert ist „false“.

ParentIds String Ja Eine durch Kommas getrennte Liste der IDs der übergeordneten Ordner, in denen der neue Ordner erstellt wird.

Ausgabeparameter

Parametername Datentyp Beschreibung
Success String Dieser Parameter gibt an, ob der Vorgang erfolgreich war.
Id String Die ID des neuen Ordners.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion CreateFolder in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion CreateFolder aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
            { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
          

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

            [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
          

DeleteResource
Beschreibung: Entfernt eine Datei oder einen Ordner dauerhaft aus Google Drive. Wenn Sie diese Aktion verwenden möchten, müssen Sie die eindeutige ID der Ressource angeben, die Sie löschen möchten.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID der zu löschenden Ressource.

Ausgabeparameter

Parametername Datentyp Beschreibung
Success String Dieser Parameter gibt an, ob der Vorgang erfolgreich war.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion DeleteResource in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion DeleteResource aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
            { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
          

    Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

            [{"Success": "TRUE"}]
          

DownloadFile
Beschreibung: Lädt eine Datei aus Google Drive herunter.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID der herunterzuladenden Datei.
LocalFile String Nein Der Dateipfad und der Dateiname, unter dem die Datei gespeichert werden soll. Lassen Sie das Feld leer, um die Datei stattdessen im Arbeitsspeicher zu speichern.
Encoding String Nein Der Codierungstyp für die Dateidaten. Wenn LocalFile leer ist, werden die Dateidaten in der angegebenen Codierung zurückgegeben. Die zulässigen Werte sind NONE und BASE64. Der Standardwert ist BASE64.
Overwrite Boolesch Nein Mit diesem Parameter wird festgelegt, ob die Datei überschrieben werden soll, wenn sie beim Herunterladen bereits vorhanden ist.
Der Standardwert ist „false“. Setzen Sie den Parameter auf „TRUE“, um die Datei zu überschreiben.
FileFormat String Nein Das Format, in dem die Datei heruntergeladen werden kann, und die maximale Dateigröße von 10 MB. Lassen Sie diesen Parameter leer, um das Video im Originalformat herunterzuladen. Die unterstützten Formate sind DOCX, ODT, RTF, HTML, TXT und PDF.

Ausgabeparameter

Parametername Datentyp Beschreibung
FileData String Wenn „LocalFile“ nicht angegeben ist, werden die Dateidaten mit der angegebenen Codierung zurückgegeben.
Success String Dieser Parameter gibt an, ob der Vorgang erfolgreich war.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion DownloadFile in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion DownloadFile aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Default Value ein:
            { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
          

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

            [{"FileData": "This is a test file.", "Success": "TRUE"}]
          

MoveResource
Beschreibung: Verschiebt eine Datei oder einen Ordner an einen anderen Speicherort in Google Drive. Sie müssen die ID der zu verschiebenden Ressource und die IDs der neuen übergeordneten Ordner angeben.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID der zu verschiebenden Ressource.
ParentIDs String Ja Eine durch Kommas getrennte Liste von IDs, die als übergeordnete Ordner verwendet werden sollen.
Eine Ressource in einer geteilten Ablage muss genau einen übergeordneten Ordner haben. Nur Nutzer mit der Rolle „Dateiorganisator“ oder „Administrator“ können Dateien und Ordner in einer geteilten Ablage verschieben.

Ausgabeparameter

Parametername Datentyp Beschreibung
Success String Dieser Parameter gibt an, ob der Vorgang erfolgreich war.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion MoveResource in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion MoveResource aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
            { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
          

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

            [{"Success": "TRUE"}]
          

UpdateResource
Beschreibung: Aktualisiert die Metadaten einer Datei oder eines Ordners in Google Drive. Sie können den Namen, die Beschreibung, den MIME-Typ und den Sternstatus ändern.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID der zu aktualisierenden Ressource.
Name String Ja Der neue Name der aktualisierten Datei.
Description String Nein Eine Beschreibung der Datei oder des Ordners.
MIMEType String Nein Der MIME-Typ der Datei.
Starred String Nein Dieser Parameter gibt an, ob die Ressource mit einem Sternchen markiert ist.

Der Standardwert ist „false“.

Ausgabeparameter

Parametername Datentyp Beschreibung
Success String Dieser Parameter gibt an, ob der Vorgang erfolgreich war.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion UpdateResource in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion UpdateResource aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
            { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
          

    Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

            [{"Success": "TRUE"}]
          

UploadFile
Beschreibung: Lädt eine Datei in Google Drive hoch. Sie müssen die Dateidaten und den MIME-Typ angeben. Sie können auch den übergeordneten Ordner angeben, in dem die Datei platziert werden soll, sowie einen Dateinamen für die hochgeladene Datei.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID der hochzuladenden Datei.
FileData String Ja Die hochzuladenden Dateidaten.
MIMEType String Ja Der MIME-Typ der Datei.
ParentIDs String Nein Eine durch Kommas getrennte Liste von übergeordneten Ordner-IDs, in denen die hochgeladene Datei platziert wird. Wenn nichts angegeben ist, wird die Datei in den Stammordner von „Meine Ablage“ des Nutzers hochgeladen.
Filename String Nein Der Name der Datei, die hochgeladen werden soll.

Ausgabeparameter

Parametername Datentyp Beschreibung
Success String Dieser Parameter gibt an, ob der Vorgang erfolgreich war.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion UploadFile in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion UploadFile aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
            { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
          

    Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

            [{"Success": "TRUE"}]
          

SubscribeToFileChanges
Beschreibung: Abonniert Benachrichtigungen für Änderungen an einer bestimmten Datei in Google Drive.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID der Datei, für die ein Abo abgeschlossen werden soll.
Token String Ja Das Token, das zum Abonnieren von Dateiänderungen verwendet werden soll.

Ausgabeparameter

Parametername Datentyp Beschreibung
Success String Dieser Parameter gibt an, ob der Vorgang erfolgreich war.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion SubscribeToFileChanges in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion SubscribeToFileChanges aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Default Value ein:
            {
              "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
              "Id": "Id11752060129918",
              "Address": "https://cloudsearch.googleapis.net/notifications",
              "ChannelToken": "token"
            }
          

    Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der in etwa so aussieht:

            [
              {
                "Kind": "api#channel",
                "Id": "Id11752060129918",
                "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
                "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
                "Token": "token",
                "Expiration": "1752063731000"
              }
            ]
          

SubscribeToUserChanges
Beschreibung: Abonniert Benachrichtigungen für Änderungen, die von einem bestimmten Nutzer in Google Drive vorgenommen wurden.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID des Nutzers, der abonniert werden soll.
Token String Ja Das Token, das zum Abonnieren von Nutzeränderungen verwendet werden soll.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion SubscribeToUserChanges in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion SubscribeToUserChanges aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Default Value ein:
            {
              "Id": "11752060129918",
              "Address": "https://cloudsearch.googleapis.net/notifications",
              "ChannelToken": "token"
            }
          

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

            [
              {
                "Kind": "api#channel",
                "Id": "Id11752060129918",
                "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
                "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
                "Token": "token",
                "Expiration": "1752063731000"
              }
            ]
          

StopWatchingResources
Beschreibung: Sie erhalten keine Benachrichtigungen mehr für eine zuvor angesehene Ressource.

Eingabeparameter

Parametername Datentyp Erforderlich Beschreibung
Id String Ja Die ID der Ressource, deren Überwachung beendet werden soll.
Token String Ja Das Token, das zum Beenden der Überwachung von Ressourcen verwendet werden soll.

Beispiel für einen Anwendungsfall

Das folgende Beispiel zeigt, wie die Aktion StopWatchingResources in Application Integration konfiguriert wird:

  1. Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
  2. Wählen Sie die Aktion StopWatchingResources aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Default Value ein:
            {
              "Id": "Id11752060129918",
              "Token": "token"
            }
          

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

            [
              {
                "Kind": "api#channel",
                "Id": "stopid1751971586168",
                "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
                "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
                "Token": null,
                "Expiration": "1751975186000"
              }
            ]
    

Systembeschränkungen

Der Google Drive-Connector kann maximal 2 Transaktionen pro Sekunde pro Knoten verarbeiten und drosselt alle Transaktionen, die dieses Limit überschreiten. Standardmäßig werden für eine Verbindung zwei Knoten (für eine bessere Verfügbarkeit) zugewiesen.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Nächste Schritte

Hilfe von der Google Cloud-Community erhalten

Sie können Ihre Fragen und Anregungen zu diesem Connector in der Google Cloud-Community unter Cloud-Foren posten.