Google Sheets-Authentifizierung

Voraussetzungen

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

• OAuth 2.0 Authorization code - Your Google email address and the password associated with your Google account.
• Bring your own OAuth 2.0 app - The Client ID, Client secret, and Scopes of your application.
• Service account - Service account key and Account email.

Hinweis:

Weitere Informationen zu den verschiedenen Authentifizierungstypen finden Sie im Handbuch zum Herstellen einer Verbindung mit Google Workspace 365-Aktivitäten .

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.

Weitere Informationen zur Dokumentation von Google Sheets finden Sie unter Google Sheets für Entwickler.

OAuth 2.0: Autorisierungscode

Scopes

• Mandatory scopes: openid, https://www.googleapis.com/auth/drive.
• Default scopes: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/drive.

To add more granular permissions, refer to the Google activities documentation.

Connecting allows UiPath products to interact with Google Sheets data on your behalf. This may include read, write, modify, and delete data, depending on your Google Sheets permissions. You can always remove any access in your Google Account.

Adding the Google Sheets connection

To create a connection to your Google Sheets, perform the following steps:

1. Wählen Sie in der Automation Cloud Integration Service im Leistenmenü aus.
2. From the Connectors list, select Google Sheets. You can also use the search bar to narrow down the connector.
3. Select the Connect to Google Sheets button, which redirects you to the connection page.
4. In the Authentication Type dropdown menu, select OAuth 2.0 Authorization code.
5. Select Connect.

Bringen Sie Ihre eigene OAuth 2.0-App mit

The Bring your own OAuth 2.0 app authentication type allows you to connect UiPath to Google Sheets using a custom OAuth application. You can create and manage this custom app in Google Cloud Console, instead of the default UiPath public app. This gives you greater control over consent, scopes, and security policies, and helps avoid refresh-token limits associated with shared OAuth client IDs.

Scopes

• Mandatory scopes: openid, https://www.googleapis.com/auth/drive.
• Default scopes: openid, https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile.

Hinweis:

Wenn Sie sich mit Bring your own 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 mit dem Feld Scopes deklarieren. Sie werden dann bei der Anmeldung aufgefordert, die zusätzliche Zustimmung zu erteilen.

To add more granular permissions, refer to the Google activities documentation.

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

Adding the Google Sheets connection

To create a connection to your Google Sheets, perform the following steps:

1. Wählen Sie in der Automation Cloud Integration Service im Leistenmenü aus.
2. From the Connectors list, select Google Sheets. You can also use the search bar to narrow down the connector.
3. Select the Connect to Google Sheets button, which redirects you to the connection page.
4. In the Authentication Type dropdown menu, select Bring your own OAuth 2.0 app.
5. Konfigurieren Sie Folgendes:
   • Client ID - The client ID from the OAuth 2.0 Client IDs section in your Google Cloud Console credentials.
   • Client secret - The client Secret from your Google Cloud Console credentials.
6. Select Connect.

Google-Dienstkonto

Scopes

• Mandatory scopes: openid, https://www.googleapis.com/auth/drive.
• Default scopes: openid, https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile.

To add more granular permissions, refer to the Google activities documentation.

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

Adding the Google Sheets connection

To create a connection to your Google Sheets, perform the following steps:

1. Wählen Sie in der Automation Cloud Integration Service im Leistenmenü aus.
2. From the Connectors list, select Google Sheets. You can also use the search bar to narrow down the connector.
3. Select the Connect to Google Sheets button, which redirects you to the connection page.
4. In the Authentication Type dropdown menu, select Google Service Account.
5. Konfigurieren Sie Folgendes:
   • Service Account Key - Paste the complete JSON key file downloaded from Google Cloud Console for your service account. For more details, check Create a service account key in the official Google documentation.
   Hinweis:

   For more details on how to create a service account and key, check the Create a service account page in the Google documentation.

   • Account email - You Google account email.
6. Select Connect.

Aktualisierungstokens für OAuth-Anwendungen

Google hat Aktualisierungstokenbeschränkungen für einzelne OAuth 2.0-Client-IDs. Wenn der Grenzwert erreicht wird, macht das Erstellen eines neuen Aktualisierungstokens das älteste Aktualisierungstoken automatisch ohne Warnung ungültig. Diese Grenze gilt nicht für Dienstkonten (; siehe Verwenden von OAuth 2.0 für Server-zu-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 Ihrer 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 wurde möglicherweise überschritten.

Hinweis:

Das Limit ist derzeit auf 100 Aktualisierungstoken pro Google-Konto pro OAuth 2.0 Client-ID festgelegt. Diese Anzahl kann sich ändern. Die neuesten 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.

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

Hinweis:

Die Ungültigkeit von Token führt zu fehlgeschlagenen Verbindungen und Automatisierungen können nicht ausgeführt werden, ohne Verbindungen zu reparieren.