GSuite Application Scope

UiPath.GSuite.Activities.GSuiteApplicationScope

Beschreibung

Verwaltet den Verbindungs-Client und die Authentifizierung für Google Workspace-Aktivitäten. Die Google Workspace-Aktivitäten funktionieren mit dem Konto, das im Anwendungs-Scope angegeben ist. Mehrere Authentifizierungstypen sind verfügbar.

Ab Version 2.5.5 können Sie die neueren Google Workspace-Aktivitäten innerhalb der Scope-Aktivität verwenden. Informationen zur Verwendung der Integration Service-Aktivitäten mit dem Google Workspace Application Scope finden Sie unter Verwendung von Google Workspace-Aktivitäten ohne Integration Service.

Bekanntes Problem

Wichtig:

Der Authentifizierungstyp OAuthClientID mit Verwendung des UiPath OAuth Client (die öffentliche UiPath-App) in Google Workspace Scope ist derzeit nicht verfügbar. Automatisierungen, die die öffentliche UiPath-App zur Authentifizierung verwenden, funktionieren möglicherweise nicht mehr und geben die folgende Fehlermeldung aus: „Diese App ist blockiert“. Wir arbeiten daran, das Problem zu beheben und die App wiederherzustellen.

Bis wir die öffentliche App wiederherstellen, können Sie die OAuthClientID-Authentifizierung mit einer benutzerdefinierten Google-Anwendung verwenden, die von Ihrer Organisation erstellt wurde. Führen Sie die folgenden Schritte aus, um von der öffentlichen UiPath Google-Anwendung zu einer benutzerdefinierten Google-Anwendung zu wechseln:

1. Erstellen Sie Ihre eigene Google Cloud-Anwendung, weisen Sie die erforderlichen Scopes zu und erstellen Sie die OAuth Client-ID-Anmeldeinformationen, wie unter Einrichten von Anwendungen in Google Cloud erläutert.
   • Die öffentliche UiPath-App verwendet die folgenden Scopes: https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/spreadsheets, https://www.googleapis.com/auth/documents, https://www.googleapis.com/auth/drive, https://mail.google.com. Sie können dieselben Scopes verwenden oder benutzerdefinierte Scopes zuweisen, je nach Ihren Anforderungen.
2. Wenn Sie den Authentifizierungstyp OAuthClientID auswählen, legen Sie das Feld OAuth Client auf „Benutzerdefiniert“ fest. Fügen Sie in den Feldern Client-ID und Geheimer Clientschlüssel die Anmeldeinformationen Ihrer benutzerdefinierten App hinzu.
   
   

   

   
   
3. Testen Sie Ihre Automatisierung, veröffentlichen Sie das Projekt erneut und führen Sie es aus.

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

• Verbindungsmethode – Wählen Sie die Verbindungsmethode aus, die Sie verwenden möchten. Die im Dropdownmenü verfügbaren Optionen sind:
  • Eigenschaftenbereich – Konfigurieren Sie die Verbindungsdetails im Eigenschaftenbereich.
  • Asset – Verwenden Sie Orchestrator-Anmeldeinformationsassets. Wir empfehlen Ihnen, diese Option zu verwenden.

Asset-Verbindungsmethode

Wenn Sie diese Option auswählen, werden die Authentifizierungsfelder, die in der Option Eigenschaftenbereich angezeigt werden, ausgeblendet, da alle Authentifizierungsinformationen im Asset gespeichert sind.

Die Asset-Methode unterstützt die gleichen Authentifizierungstypen wie die Eigenschaftenbereich-Methode: OAuth-Client-ID, API-Schlüssel oder Dienstkontoschlüssel.

• Verbindungs-Assets – Durchsuchen Sie die Orchestrator-Ordner, um ein Asset auszuwählen. Dieses Feld unterstützt IResource -Variablen. Wählen Sie die Schaltfläche Assets verwalten aus, um den Orchestrator zu öffnen. Die Liste der verfügbaren Assets hängt vom Orchestrator ab, mit dem Ihr Studio und Ihr Roboter verbunden sind.
  • Verwenden Sie das Schaltflächenmenü Plus, um Assets neu laden auszuwählen, wenn Sie Ihre Assets im Orchestrator aktualisiert haben. Beachten Sie Folgendes: Wenn Sie ein neues Asset im Orchestrator hinzufügen, während Studio Desktop verwendet wird, ist dieses nicht sofort in der Scope-Aktivität verfügbar.

Allgemein

• TimeoutMS – Ist diese Option aktiviert, wird die Aktivität nach der festgelegten Anzahl von Millisekunden mit einem Timeout beendet.

Optionen

• Speicherort für Verbindungsdaten – Eine Dropdownliste, die angibt, wo die Tokenantwort gespeichert wird. Die verfügbaren Eigenschaftswerte sind Lokaler Datenträger, Orchestrator oder Niemals speichern.

  • Lokaler Datenträger – Die Verbindungstoken werden in einem lokalen Ordner auf der Maschine gespeichert. Dieselbe Verbindung kann in mehreren Prozessen auf derselben Maschine verwendet werden.
  • Orchestrator – Die Verbindungstoken werden im Orchestrator als Assets in einem angegebenen Ordner gespeichert. Dieselbe Verbindung kann in mehreren Prozessen auf mehreren Maschinen verwendet werden, solange sie Zugriff auf den angegebenen Orchestrator-Ordner hat.
  • Niemals speichern – Die Verbindungstoken werden nie gespeichert.
• Verbindungs-Orchestrator-Ordnerpfad – Der Orchestrator-Ordner, in dem die Operationen ausgeführt werden. Leer lassen, wenn moderne Ordner nicht aktiviert sind. Weitere Informationen finden Sie unter Über Ordner im Orchestrator-Handbuch.

Service Account Key

• Benutzer-E -Mail: Wenn Sie dem Dienstkonto einen domainweiten Zugriff gewährt haben, muss es die Identität eines Benutzers von der Domain annehmen. Verwenden Sie dieses Feld, um die E-Mail-Adresse des Benutzers einzugeben, dessen Identität angenommen wird.

Laufzeit

• Runtime-Verbindungsassets – Durchsuchen, um ein Asset auszuwählen. In diesem Feld können Sie ein anderes Asset für die Laufzeit auswählen. Verwenden Sie das Schaltflächenmenü Plus, um Relativer Pfad auszuwählen, und geben Sie den vollständigen Pfad des Orchestrator-Assets ein, das die Verbindungsdetails enthält.

Verbindungsmethode für den Eigenschaftenbereich

• Verbindungen – Wählen Sie ein Konto aus der Liste aus. Sie können Verbindungen hinzufügen, löschen und auswählen, welche verwendet werden sollen.
• Authentifizierungs-Scopes – Siehe Abschnitt Verwenden der Authentifizierungs-Scopes unten.

Verwenden des Assistenten für Authentifizierungs-Scopes

Die Aktivität Scope enthält einen universellen Berechtigungsselektor, der ein klares Bild aller verwendeten Authentifizierungs-Scopes bietet, die die Aktivitäten benötigen, um ordnungsgemäß zu funktionieren.

Alle untergeordneten Aktivitäten in der Aktivität Google Workspace Application Scope werden automatisch als erforderliche Scopes erkannt.

Wenn im Scopes-Assistenten keine Scopes manuell ausgewählt werden, wird die Funktion „Automatische Erkennung“ standardmäßig zur Laufzeit angewendet; die Konfiguration des Assistenten ist nicht mehr erforderlich. Alle minimal erforderlichen Scopes werden zur Laufzeit ausgewählt.

Sie können einen Scope auch manuell hinzufügen, nachdem Sie eine untergeordnete Aktivität zum Google Workspace-Anwendungsbereich hinzugefügt haben.

Hinweis: Weitere Informationen zu API-Scopes und -Berechtigungen finden Sie unter Microsoft 365 und Google Workspace Cards – API-Berechtigungen und -Scopes.

Authentication

• Authentifizierungstyp – Eine Dropdownliste, die den Authentifizierungstyp angibt, den Sie für den Zugriff auf Google Workspace-Dienste verwenden möchten. Die verfügbaren Eigenschaftswerte sind: APISchlüssel, OAuthClientID und Servicekontoschlüssel. Je nach Auswahl des Authentifizierungstyps können zusätzliche Eigenschaftsfelder erforderlich sein.

OAuth Client ID

Hinweis: Dies ist dieselbe Authentifizierungsmethode, die im Integration Service unterstützt wird, entweder über die öffentliche UiPath-App oder eine private benutzerdefinierte Anwendung (Bring Ihre eigene App-Methode mit).

Die folgenden Eigenschaftsfelder sind nur erforderlich, wenn der Wert Ihres Authentifizierungstyps OAuthClientID ist.

• ClientID – Die Anmeldeinformations-ID für das Benutzerkonto. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• ClientGeheimnis – Das Anmeldeinformationsgeheimnis für das Benutzerkonto. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• OAuth-Client – Gibt die zu verwendende Anwendung (Client) an. Wenn UiPath ausgewählt ist, dürfen Client-ID und geheimer Clientschlüssel nicht angegeben werden. Der Standardwert ist UiPath.
• SicheresClientGeheimnis – Der geheime Clientschlüssel für das Benutzerkonto als sicherer String. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
  Hinweis:

  Wenn Sie UiPath Apps verwenden, erlauben Sie UiPath Robotern, auf die Daten innerhalb Ihres Google Mail-Kontos zuzugreifen. Anschließend erlauben Sie UiPath Robotern, die Daten ausschließlich gemäß Ihren Anweisungen zu bearbeiten. UiPath wird niemals auf die Daten zugreifen, sie speichern oder in irgendeiner Weise verarbeiten, die Sie mit Hilfe der UiPath-Roboter bearbeiten, und lässt nicht zu, dass die Roboter außerhalb der Instruktionen des Benutzers verwendet werden. Die Verwendung der von Google APIs erhaltenen Informationen durch UiPath erfolgt gemäß der Google API Services User Data Policy, einschließlich der Anforderungen zur eingeschränkten Nutzung.

  Weitere Informationen finden Sie in der vollständigen UiPath Datenschutzerklärung.

• Speicherort für Verbindungsdaten – Eine Dropdownliste, die angibt, wo die TokenAntwort gespeichert wird. Die verfügbaren Eigenschaftswerte sind Lokaler Datenträger, Orchestrator oder Niemals speichern. Diese Eigenschaft ist nur relevant, wenn der ausgewählte Authentifizierungstyp OAuthClientID ist.

• Verbindungs-Orchestrator-Ordnerpfad – Der Orchestrator-Ordner, in dem die Operationen ausgeführt werden. Leer lassen, wenn moderne Ordner nicht aktiviert sind. Weitere Informationen finden Sie unter Über Ordner im Orchestrator-Handbuch.

• Benutzer – Der Bezeichner, der einem autorisierten Benutzer zugewiesen ist. Für jeden Bezeichner wird ein eindeutiges Antwort-Token generiert, das zur späteren Verwendung gespeichert werden kann. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte. Diese Eigenschaft ist nur relevant, wenn der ausgewählte Authentifizierungstyp OAuthClientID ist.

Service Account Key

Die folgenden Eigenschaftsfelder sind nur erforderlich, wenn der Wert Ihres Authentifizierungstyps Dienstkontoschlüssel ist.

• Schlüsseltyp – Eine Dropdownliste, die den Dienstkontotyp entsprechend der Schlüsseldatei angibt. Die verfügbaren Eigenschaftswerte sind JSON und P12. Für einen P12-Dienstkontotyp sind die Eigenschaften Kennwort und Dienstkonto -E-Mail erforderlich.
• Dienstkonto-E- Mail – Die automatisch generierte E-Mail-Adresse für das Dienstkonto. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte und ist nur erforderlich, wenn der Wert Ihres Schlüsseltyps P12 ist.
• Benutzer-E-Mail - Wenn Domain-weiter Zugriff ausgewählt ist, gibt das Dienstkonto die Identität eines Benutzers von der Domain an; Verwenden Sie dieses Feld, um die E-Mail-Adresse des Benutzers einzugeben, dessen Identität angenommen wird.
• Hat domainweiten Zugriff – Wenn diese Option ausgewählt ist, gewährt die Aktivität domänenweiten Zugriff auf das Dienstkonto. Boolescher Wert.
• Schlüsselpfad – Der Pfad zur Datei mit den Servicekontoschlüsseln. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte. Bei der Erstellung eines Dienstkontos in der Google Cloud Platform wird eine Schlüsseldatei zum Herunterladen generiert.
• Kennwort – Das Kennwort für das Dienstkonto. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte und ist nur erforderlich, wenn der Wert Ihres Schlüsseltyps P12 ist.
• Orchestrator Speicher-Bucket mit Schlüssel – Der Speicher-Bucket, der zum Abrufen der durch den Schlüsselpfad angegebenen Anmeldeinformationen verwendet wird. Wenn ein Speicher-Bucket ausgewählt ist, muss das Feld „Schlüsselpfad“ den Dateipfad im ausgewählten Speicher-Bucket angeben. Wenn kein Speicher-Bucket festgelegt ist, verwendet der Schlüsselpfad einen lokalen Speicher. Wenn Sie den Eingabemodus Vollständiger Pfad auswählen, können Sie den Pfad des Speicher-Buckets als Zeichenfolge eingeben oder eine Variable verwenden.
  Hinweis: Mit dieser Option können Sie die Authentifizierung mit Dienstkontoschlüssel im Unattended-Modus viel einfacher verwenden. Sie müssen die P12- oder JSON-Datei nicht mehr im Projektordner hinzufügen.

API-Schlüssel

Die folgenden Eigenschaftsfelder sind nur erforderlich, wenn der Wert des Authentifizierungstyps APISchlüssel ist.

• API -Schlüssel – Der API-Schlüssel des Kontos. Sie dürfen den API-Schlüssel nur mit den Google Sheets-Aktivitäten verwenden. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte. Wenn Sie die Aktivitäten Google Mail, Google Calendar und/oder Google Drive verwenden möchten, müssen Sie einen anderen Wert für den Authentifizierungstyp auswählen.

Allgemein

• ContinueOnError – Wenn festgelegt, werden die verbleibenden Aktivitäten ausgeführt, wenn die aktuelle Aktivität fehlschlägt.
• TimeoutMS – Ist diese Option aktiviert, wird die Aktivität nach der festgelegten Anzahl von Millisekunden mit einem Timeout beendet.

Die Verwendung der von UiPath in Verbindung mit Google Software entwickelten und bereitgestellten Software unterliegt der UiPath Open Platform Activity-Lizenzvereinbarung. Google Software und Services, die zusammen mit der UiPath Software verwendet werden, können gemäß den Google Nutzungsbedingungen und anderen geltenden Vereinbarungen, Richtlinien oder Leitfäden, die Google bereitstellt, abgerufen und verwendet werden.