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 IdString Ja Die ID der zu kopierenden Ressource. NewNameString Ja Der neue Name der kopierten Datei. ParentIDsString 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. IgnoreDefaultVisibilityBoolesch 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“.
IncludeLabelsString Nein Eine durch Kommas getrennte Liste mit IDs von Labels, die im Teil „labelInfo“ der Antwort enthalten sein sollen. IncludePermissionsForViewString 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. KeepRevisionForeverBoolesch 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“.
OCRLanguageString 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.
enfür Englisch unddefür Deutsch.SupportsAllDrivesBoolesch 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 CopiedFileIDString Die ID der kopierten Datei. SuccessString Dieser Parameter gibt an, ob der Vorgang erfolgreich war. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
CopyResourcein Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
CopyResourceaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in das FeldDefault Valueein:{ "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}Wenn die Aktion erfolgreich ist, hat der Antwortparameter
connectorOutputPayloadder 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 NameString Ja Der Titel des Ordners. DescriptionString Nein Die Beschreibung des Ordners. StarredBoolesch Nein Dieser Parameter gibt an, ob der Ordner mit einem Sternchen markiert ist. Der Standardwert ist „false“.
ParentIdsString Ja Eine durch Kommas getrennte Liste der IDs der übergeordneten Ordner, in denen der neue Ordner erstellt wird. Ausgabeparameter
Parametername Datentyp Beschreibung SuccessString Dieser Parameter gibt an, ob der Vorgang erfolgreich war. IdString Die ID des neuen Ordners. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
CreateFolderin Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
CreateFolderaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in FeldDefault Valueein:{ "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}Wenn die Aktion erfolgreich ist, hat der Antwortparameter
connectorOutputPayloadder 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 IdString Ja Die ID der zu löschenden Ressource. Ausgabeparameter
Parametername Datentyp Beschreibung SuccessString Dieser Parameter gibt an, ob der Vorgang erfolgreich war. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
DeleteResourcein Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
DeleteResourceaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in FeldDefault Valueein:{ "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}Wenn die Aktion erfolgreich ist, hat der Antwortparameter
connectorOutputPayloadder 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 IdString Ja Die ID der herunterzuladenden Datei. LocalFileString 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. EncodingString 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. OverwriteBoolesch 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.FileFormatString 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 FileDataString Wenn „LocalFile“ nicht angegeben ist, werden die Dateidaten mit der angegebenen Codierung zurückgegeben. SuccessString Dieser Parameter gibt an, ob der Vorgang erfolgreich war. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
DownloadFilein Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
DownloadFileaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in das FeldDefault Valueein:{ "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
connectorOutputPayloadder 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 IdString Ja Die ID der zu verschiebenden Ressource. ParentIDsString 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 SuccessString Dieser Parameter gibt an, ob der Vorgang erfolgreich war. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
MoveResourcein Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
MoveResourceaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in FeldDefault Valueein:{ "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}Wenn die Aktion erfolgreich ist, hat der Antwortparameter
connectorOutputPayloadder 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 IdString Ja Die ID der zu aktualisierenden Ressource. NameString Ja Der neue Name der aktualisierten Datei. DescriptionString Nein Eine Beschreibung der Datei oder des Ordners. MIMETypeString Nein Der MIME-Typ der Datei. StarredString Nein Dieser Parameter gibt an, ob die Ressource mit einem Sternchen markiert ist. Der Standardwert ist „false“.
Ausgabeparameter
Parametername Datentyp Beschreibung SuccessString Dieser Parameter gibt an, ob der Vorgang erfolgreich war. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
UpdateResourcein Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
UpdateResourceaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in FeldDefault Valueein:{ "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
connectorOutputPayloadder 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 IdString Ja Die ID der hochzuladenden Datei. FileDataString Ja Die hochzuladenden Dateidaten. MIMETypeString Ja Der MIME-Typ der Datei. ParentIDsString 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. FilenameString Nein Der Name der Datei, die hochgeladen werden soll. Ausgabeparameter
Parametername Datentyp Beschreibung SuccessString Dieser Parameter gibt an, ob der Vorgang erfolgreich war. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
UploadFilein Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
UploadFileaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in FeldDefault Valueein:{ "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
connectorOutputPayloadder 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 IdString Ja Die ID der Datei, für die ein Abo abgeschlossen werden soll. TokenString Ja Das Token, das zum Abonnieren von Dateiänderungen verwendet werden soll. Ausgabeparameter
Parametername Datentyp Beschreibung SuccessString Dieser Parameter gibt an, ob der Vorgang erfolgreich war. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
SubscribeToFileChangesin Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
SubscribeToFileChangesaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in das FeldDefault Valueein:{ "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY", "Id": "Id11752060129918", "Address": "https://cloudsearch.googleapis.net/notifications", "ChannelToken": "token" }Wenn die Aktion erfolgreich ist, hat der Antwortparameter
connectorOutputPayloadder 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 IdString Ja Die ID des Nutzers, der abonniert werden soll. TokenString Ja Das Token, das zum Abonnieren von Nutzeränderungen verwendet werden soll. Beispiel für einen Anwendungsfall
Das folgende Beispiel zeigt, wie die Aktion
SubscribeToUserChangesin Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
SubscribeToUserChangesaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in das FeldDefault Valueein:{ "Id": "11752060129918", "Address": "https://cloudsearch.googleapis.net/notifications", "ChannelToken": "token" }Wenn die Aktion erfolgreich ist, hat der Antwortparameter
connectorOutputPayloadder 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 IdString Ja Die ID der Ressource, deren Überwachung beendet werden soll. TokenString 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
StopWatchingResourcesin Application Integration konfiguriert wird:- Klicken Sie im Dialogfeld Connector-Aufgabe konfigurieren auf Aktionen.
- Wählen Sie die Aktion
StopWatchingResourcesaus und klicken Sie auf Fertig. - Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf
connectorInputPayloadund geben Sie dann einen Wert ähnlich dem folgenden in das FeldDefault Valueein:{ "Id": "Id11752060129918", "Token": "token" }Wenn die Aktion erfolgreich ist, hat der Antwortparameter
connectorOutputPayloadder 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
- Weitere Informationen zum Erstellen und Konfigurieren einer Google Drive-Verbindung
- Verbindungen anhalten und fortsetzen
- Connector-Nutzung überwachen
- Connector-Logs ansehen