Google Docs-Authentifizierung

Voraussetzungen

Je nach ausgewähltem Authentifizierungstyp benötigen Sie eine der folgenden Anmeldeinformationen:

• OAuth 2.0-Autorisierungscode: Ihre Google-E-Mail-Adresse und das Passwort, das Ihrem Google-Konto zugeordnet ist.
• Nutzen Sie Ihre eigene OAuth 2.0-App: Die Client-ID, der geheime Clientschlüssel und die Scopes Ihrer Anwendung.
• Dienstkonto: Dienstkontoschlüssel, Konto-E-Mail.

Wenn Ihr Konto nicht von Google aktiviert ist:

• Wenden Sie sich an Ihren Administrator, um Genehmigungen zum Erstellen von Verbindungen zu erhalten.
• Aktivieren Sie die Berechtigung, indem Sie die verfügbaren Optionen zum Erstellen einer Verbindung überprüfen.

For more details regarding the different authentication types, see the How to connect to Google Workspace 365 activities guide.

Weitere Informationen zu Google Docs finden Sie in der Google Docs-Entwicklerdokumentation.

Scopes

Der Connector fordert die folgenden Berechtigungen/Scopes an:

• Standard-Scopes der öffentlichen UiPath-App: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Standard-Scopes für Dienstkonten: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://mail.google.com/, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.settings.basic.
• Nutzen Sie Ihre eigene OAuth 2.0-App:
  • Mindest-Scopes für das Erstellen einer Verbindung: openid, https://www.googleapis.com/auth/drive.readonly.
  • Mindestliste der Scopes, die für Google Docs-Trigger erforderlich sind:
    • openid, https://www.googleapis.com/auth/drive.readonly

Hinweis: Wenn Sie sich mit Bring your eigener OAuth 2.0-App authentifizieren, profitieren Sie standardmäßig von den Scopes, die bei der App-Erstellung konfiguriert wurden. Wenn Sie die Standard-App-Berechtigungen verwenden möchten, können Sie einen common -Scope deklarieren. Das bedeutet, dass Sie nur die Berechtigungen verwenden, die für diese Anwendung konfiguriert sind. Sie können auch zusätzliche Scopes bei der Verbindungserstellung deklarieren, indem Sie das Feld Scopes verwenden. Sie werden dann bei der Anmeldung aufgefordert, die zusätzliche Zustimmung zu erteilen.

Durch das Herstellen einer Verbindung können UiPath-Produkte in Ihrem Namen mit Google Docs-Daten interagieren. Dies kann das Lesen, Schreiben, Ändern und Löschen von Daten umfassen, je nach Ihren Google Docs-Berechtigungen. Sie können jeden Zugriff in Ihrem Google-Konto jederzeit entfernen.

Fügen Sie die Google Docs-Verbindung hinzu

1. Wählen Sie Integration Service in der Automation Cloud^TM aus.

2. Wählen Sie in der Liste Connectors die Option Google Docs aus. Sie können auch die Suchleiste verwenden, um den Connector zu finden.

3. Wählen Sie die Schaltfläche Verbindung hinzufügen aus.

4. Sie werden nun zur Verbindungsseite weitergeleitet. Wählen Sie Ihren bevorzugten Authentifizierungstyp aus.

   Wenn Sie Ihre eigene OAuth 2.0-App mitbringen auswählen, müssen Sie eine Client-ID und einen geheimen Clientschlüssel sowie die Scopes angeben, die Sie möglicherweise für die Interaktion mit verschiedenen Aktivitäten benötigen. Lesen Sie die Dokumentation der Aktivitäten, um zu sehen, welche Scopes sie erfordern.

5. Ihre Verbindung wurde hinzugefügt.

Aktualisierungstokens für OAuth-Anwendungen

Google hat Aktualisierungstokenbeschränkungen für einzelne OAuth 2.0 Client-IDs. Wenn der Grenzwert erreicht ist, wird beim Erstellen eines neuen Aktualisierungstokens das älteste Aktualisierungstoken automatisch und ohne Warnung ungültig. Diese Begrenzung gilt nicht für Dienstkonten (siehe Verwenden von OAuth 2.0 für Server-to-Server-Anwendungen). Weitere Informationen finden Sie in der offiziellen Dokumentation von Google.

Eine Liste der Gründe, die zum Ablauf des Tokens führen können:

• Sie haben den Zugriff auf Ihre App widerrufen.
• Das Aktualisierungstoken wurde seit sechs Monaten nicht mehr verwendet.
• Sie müssen Kennwörter ändern, und das Aktualisierungstoken enthält Gmail-Scopes.
• Ihr Konto hat eine maximale Anzahl von gewährten (Live-)Aktualisierungstokens überschritten.
  • Wenn Sie ein neues Token anfordern, nachdem der Grenzwert überschritten wurde, läuft Ihre alte Verbindung, die auf einem zuvor gewährten Token basiert, ab. Nur die neue Verbindung oder die zuletzt bearbeitete/erneut authentifizierte Verbindung (mit dem neuesten Token) funktioniert.
• Ein Administrator hat einen der in den Scopes Ihrer Anwendung angeforderten Dienste auf Eingeschränkt festgelegt (der Fehler ist admin_policy_enforced).
• Bei Google Cloud Platform APIs: Die vom Administrator festgelegte Sitzungslänge könnte überschritten worden sein.

Hinweis: Das Limit ist derzeit auf 100 Aktualisierungstoken pro Google-Konto pro OAuth 2.0-Client-ID festgelegt. Diese Zahl kann sich ändern. Aktuelle Informationen finden Sie immer in der Google-Dokumentation.

Es gibt eine höhere Grenze für die Gesamtanzahl der Aktualisierungstokens, die ein Benutzer- oder Dienstkonto für alle Clients haben kann. Reguläre Benutzer werden diesen Grenzwert nicht überschreiten, bei einem Entwicklerkonto jedoch, das zum Testen einer Implementierung verwendet wird, möglicherweise.

Um sicherzustellen, dass dieser Grenzwert nicht überschritten wird, bietet UiPath Benutzern die Möglichkeit, eigene OAuth-Anwendungen zu erstellen und eine Verbindung mithilfe des Authentifizierungstyps Eigene App herstellen. Stellen Sie sicher, dass Sie die Best Practices von Google beim Erstellen Ihrer OAuth-Anwendung befolgen. Weitere Informationen zum Erstellen einer OAuth-Anwendung finden Sie in der offiziellen Dokumentation von Google.

Warnung: Tokenannullierung führt zu fehlgeschlagenen Verbindungen, und Automatisierungen können nicht ausgeführt werden, ohne Verbindungen zu reparieren.