So verwenden Sie Google Workspace-Aktivitäten ohne Integration Service

Über

Sie können jetzt die neueren Google Workspace-Aktivitäten über den GSuite Application Scope verwenden, auch wenn Sie keinen Integration Service haben.

Die speziell für den Integration Service entwickelten Google Workspace-Aktivitäten verfügen über ein Feld Verbindung, mit dem Sie eine Verbindung auswählen können, die über einen Integration Service-Connector erstellt wurde. Bei Verwendung innerhalb des GSuite Application Scope erben die Aktivitäten einfach die Verbindungsinformationen aus dem Scope.

Matrix von Authentifizierungs- und Projekttypen

Google Workspace
	Cloud		Lokal
	GSuite Anwendungsbereich	Integration Service	GSuite Anwendungsbereich	Integration Service
Plattformübergreifend
API-Schlüssel	❌	❌	❌	❌
OAuth - Bringen Sie OAuth durch OAuth auf	❌	✅	❌	❌
OAuth – UiPath App	❌	✅	❌	❌
Dienstkonto	❌	❌	❌	❌
Windows
API-Schlüssel	✅	❌	✅	❌
OAuth - Bringen Sie OAuth durch OAuth auf	✅	✅	✅	❌
OAuth – UiPath App	✅	✅	✅	❌
Dienstkonto	✅	❌	✅	❌

Verbindungsmethoden

Es gibt zwei Möglichkeiten, eine Verbindung in der Aktivität GSuite Application Scope einzurichten.

Verbindungsmethode		Beschreibung	Vorteile	Nachteile
Asset Hinweis: Empfohlen.		Verwendet ein Orchestrator-Asset, um die Verbindung zusammen mit der Scope-Konfiguration zu speichern. Das Asset hat ein JSON-Format. Bei jeder Verwendung ruft die Aktivität die Konfiguration aus dem Asset ab. Basierend auf der Asset-Konfiguration verhält sich der Scope unterschiedlich; Sie identifiziert den Authentifizierungstyp und blendet nicht benötigte Felder aus. Wenn die Asset-JSON nicht richtig festgelegt ist, wird ein Validierungsfehler ausgelöst.	Die Aktivitäten profitieren von Suchen zur Entwurfszeit und können Dateien, Ordner, Listen, Bereiche usw. erkennen. Die Verbindung ist leicht übertragbar, da Anmeldeinformationen nicht im Klartext von einem Benutzer an einen anderen weitergegeben werden. Kann von einem Administrator konfiguriert werden. Es ist sicherer, da die Anmeldeinformationen den Studio-Workflow nicht erreichen.	Erfordert einen fortgeschrittenen Benutzer, um das Asset zu konfigurieren. Für einen Citizen Developer nicht einfach einzurichten.
Eigenschaften-Panel		Verwenden Sie den vorhandenen Eigenschaftenbereich, um die Verbindungsanmeldeinformationen zu konfigurieren. Die Konfiguration kann im Klartext oder über Variablen hinzugefügt werden.	Einfacher zu verwenden. Die Abwärtskompatibilität bleibt erhalten.
	Konfiguration durch Klartext Hinweis: Nicht empfohlen.	Konfigurieren Sie den Eigenschaftenbereich mit Nur-Text-Werten.	Die Aktivitäten profitieren von Suchen zur Entwurfszeit und können Dateien, Ordner, Listen, Bereiche usw. erkennen.	Weniger sicher, weil die Anmeldeinformationen in Klartext zwischen Benutzern übergeben werden müssen.
	Konfiguration über Variablen	Konfigurieren Sie den Eigenschaftenbereich mit Variablen.	Mehr Sicherheit, da die Anmeldeinformationen den Studio-Workflow nicht erreichen.	Die Aktivitäten können zur Entwurfszeit keine Ressourcen erkennen.

Asset-Format des GSuite-Anwendungsumfangs

{
    "ApiKey": "",
    "OAuth2ConnectionData": {
        "OAuth2AppData": {
            "ClientId": "",
            "ClientSecret": ""
        }
    },
    "SacConnectionData": {
        "EmailAddress": "",
        "KeyPath": "",
        "ServiceAccountEmail": "",
        "Password": "notasecret",
        "BucketId": "",
        "HasDomainWideAccess": true | false
    },
   "AuthenticationMethod": "oauth2" | "sac" | "apikey"
}

Einschränkungen

Die folgenden Funktionen sind nicht verfügbar, wenn Aktivitäten innerhalb des GSuite Application Scope verwendet werden: Trigger, Bindungen und Überschreibungserfahrung.

Tokenaktualisierung

Es ist kein Dienst zum Aktualisieren Ihrer Verbindungstoken verfügbar, wie der, der im Integration Service verfügbar ist.

Wenn das Autorisierungstoken eine bestimmte Anzahl von Tagen lang nicht aktualisiert wird, läuft es ab und Sie müssen sich erneut authentifizieren. Um das Ablaufen von Autorisierungstokens zu vermeiden, führen Sie einen Roboter mit dieser speziellen Verbindung aus. Beim Ausführen einer Automatisierung mit der Scope-Aktivität wird das Autorisierungstoken aktualisiert.

Zusätzliche OAuth 2.0-Ressourcen:

• Verwenden von OAuth 2.0 für den Zugriff auf Google APIs | Autorisierung | Google für Entwickler