Aktion „Verbinden“ für Google-Pakete

Verwenden Sie die Aktion Verbinden, um eine Verbindung mit dem Google-Server herzustellen, um andere Aktionen von demselben Paket zu verwenden, um Aufgaben zu automatisieren. Alle Felder in dieser Aktion akzeptieren Anmeldedaten aus dem Credential Vault, eine Variable oder einen vom Nutzer eingegebenen Wert.

Vorbereitungen

Konfigurieren Sie die OAuth-Einstellungen in Google Cloud-Plattform und rufen Sie die erforderlichen Anmeldedaten ab, um Automation Anywhere mit Ihren Google G Suite-Anwendungen zu verbinden.
  1. Wenn Sie dies noch nicht getan haben, Erstellen Sie ein Projekt.
  2. Aktivieren Sie die APIs für die Google G Suite-Anwendungen, die Sie automatisieren möchten, z. B. die Google Drive-API, Google Calendar-API und Google Sheets-API.
  3. Führen Sie die Schritte unter Einrichten von OAuth 2.0 aus, um die Client-ID und das Geheimnis zu generieren.
    Anmerkung:
    • Wählen Sie die Option Webanwendung und geben Sie einen Namen ein.
    • Geben Sie auf der Grundlage des Authentifizierungsmodus den entsprechenden Umleitungs-URI wie unten angegeben ein:
      • Autorisierungscode (Standard-Authentifizierungsmodus): Fügen Sie diesen autorisierten Umleitungs-URI hinzu: http://localhost:8888/Callback
      • Control Room-verwaltet: Fügen Sie die Callback-URL von der Seite Control Room > Verwalten > OAuth-Verbindungen > Verbindungseinstellungen hinzu. Einzelheiten finden Sie unter Herstellung der OAuth-Verbindung.

Prozedur

  1. Doppelklicken Sie in der Aktionen-Palette auf die Aktion Verbinden oder ziehen Sie sie aus dem Paket, das Sie nutzen möchten.
  2. Im Feld Nutzernamekönnen Sie einen gültigen Nutzernamen eingeben oder die Anmeldedaten oder die Anmeldedaten-Variable auswählen, die Ihren Google-Nutzernamen enthält. Um einen Wert einzugeben, klicken Sie auf Unsichere Zeichenfolge.
  3. Wenn Sie die Aktion Verbinden für den Google Calendar oder das Google Sheets-Paket konfigurieren, geben Sie einen Sitzungsnamen ein.
  4. Klicken Sie auf die Dropdown-Liste OAuth2-Authentifizierungsmodus und wählen Sie einen der folgenden Authentifizierungsmodi aus:

    Wählen Sie bei einem Authentifizierungsmodus die Option Autorisierungscode. Dies ist ein veralteter Ablauf, der nicht sicher ist. Wählen Sie bei einem unbeaufsichtigten Authentifizierungsmodus die Control Room-verwaltete OAuth2-Authentifizierung aus, ein sichereres und standardmäßigeres Modell für Automatisierungen.

    • Authentifizierungscode
      • Wählen Sie im Feld Client-ID die Anmeldedaten oder die Anmeldedaten-Variable aus, die die Client-ID enthält. Um einen Wert einzugeben, klicken Sie auf Unsichere Zeichenfolge.
      • In das Feld URI umleiten geben Sie http://localhost:8888/Callback ein.
        Anmerkung: Für das Google Sheets-Paket wird das Attribut URI umleiten nicht unterstützt. Geben Sie die feste Umleitungs-URL direkt in Google Cloud-Plattform ein: http://localhost:8888/Callback
      • Wählen Sie im Feld Geheimer Clientschlüssel die Anmeldedaten oder die Anmeldedaten-Variable aus, die das Zugriffstoken enthält. Um einen Wert einzugeben, klicken Sie auf Unsichere Zeichenfolge.
    • Control Room verwaltet:

      Um vom Control Room verwaltetes OAuth2 in Google-Paketen zu verwenden, müssen Sie die OAuth-Verbindung im Control Room konfigurieren. Einzelheiten finden Sie unter Herstellung der OAuth-Verbindung.

      Aktualisieren Sie die Informationen in den folgenden Feldern:

      • Verbindung: Klicken Sie auf die Schaltfläche Wählen..., um einen Verbindungstyp auszuwählen.
      • Wählen Sie im Feld Anbieter-Typ die Option Benutzerdefiniert.
      • Wählen Sie den Verbindungsnamen, den Sie im Control Room für Google Workspace-Apps eingerichtet haben.

      • Wählen Sie im Feld Tokentyp eine der folgenden Optionen aus:

        Informationen zu den Zugriffs- und Aktualisierungstokens der Google Workspace-Anwendung finden Sie unter Konfiguration von Unternehmensanwendungen.

        • Freigegeben: Wählen Sie diese Option, wenn das OAuth2-Zugangstoken von allen Nutzern, die die Automatisierung ausführen, gemeinsam genutzt wird. Beachten Sie: Dies erfordert, dass der Control Room-Administrator oder ein beliebiger Nutzer (mit aktivierten Optionen „Verbindungen verwalten“ und „Verbindungen anzeigen“ für die OAUTH-VERBINDUNGEN) eine OAuth-Verbindung im Control Room einrichtet. Speichern Sie die Anmeldedaten einmalig, um ein gemeinsames Zugriffstoken zu generieren, das von allen Nutzern, die die Automatisierung ausführen, verwendet werden kann.
        • Benutzerspezifisch: Wählen Sie diese Option, wenn das OAuth2-Zugriffstoken für jeden Nutzer, der die Automatisierung ausführt, spezifisch ist. Beachten Sie: Dies erfordert, dass der Control Room-Administrator oder ein beliebiger Nutzer (mit aktivierten Optionen „Verbindungen verwalten“ und „Verbindungen anzeigen“ für die OAUTH-VERBINDUNGEN) eine OAuth-Verbindung im Control Room einrichtet. Achten Sie darauf, die Anmeldedaten nicht zu speichern, damit jeder Nutzer, der die Automatisierung ausführt, seine Anmeldedaten angeben und ein Zugriffstoken generieren kann, das nur von diesem einen Nutzer verwendet werden kann.
        • Klicken Sie auf Bestätigen.

          Verwendung der Option der vom Control Room verwalteten OAuth2-Authentifizierung

      Anmerkung: Wenn Sie die Option Benutzerspezifisch verwenden, müssen Sie sich bei Ihrem Google-Konto anmelden, um sich zu authentifizieren und ein benutzerspezifisches Token zu generieren. Führen Sie die folgenden Schritte aus, um diese Option zu nutzen:
      1. Navigieren Sie im Control Room zu Ihrem Profil Meine Einstellungen > OAuth-Verbindungen.
      2. Klicken Sie auf Anmelden, um sich zu authentifizieren.
      3. Melden Sie sich bei Ihrem Google-Konto an und wählen Sie Weiter.
      4. Überprüfen Sie die Dienste, auf die Sie Zugriff haben, und klicken Sie auf Weiter.

        Wenn die Verbindung erfolgreich ist, wird der Status Aktivangezeigt.

        Erfolgsstatus der OAuth-Authentifizierung

  5. Für Google Sheets können Sie die Wartezeit (in Minuten) im Feld Wartezeit auf Abschluss von Aktionen (in Minuten) angeben, wenn Sie Aktionen wie Abrufen, SET oder Löschen ausführen. Standardmäßig beträgt die Wartezeit 10 Minuten.
    Wenn das Google-Arbeitsblatt nicht innerhalb der von Ihnen angegebenen Zeit geöffnet wird, fährt die Aufgabe mit der Ausführung der nächsten Gruppe von Aktionen fort.
    Anmerkung: Wenn Sie die Aktion Verbinden verwenden, um sich mit dem Google-Server zu verbinden, wird die Option Wartezeit auf Abschluss von Aktionen (in Minuten) nur im Google Sheets-Paket unterstützt.
  6. Klicken Sie auf Speichern.
  7. Nachdem Sie Aktionen aus einem bestimmten Google-Paket hinzugefügt haben, verwenden Sie die Aktion Trennen aus demselben Google-Paket, um die Verbindung zu beenden.

Nächste Maßnahme

Bei der ersten Ausführung des Bots wird das Google-Anmeldefenster angezeigt. Sie müssen das Google-Konto auswählen und die angeforderten Zugriffsberechtigungen genehmigen.

Die Token-Datei wird zum ersten Mal generiert, nachdem Sie die Zugriffsberechtigungen bei der Bereitstellung des Bots bereitgestellt haben. Sie wird auf der Grundlage der Werte erstellt, die Sie in den Feldern Nutzername, Client-ID und Geheimer Clientschlüssel angeben, und fragt nur beim ersten Mal nach den Anmeldedaten, um die Zugangsberechtigung zu erteilen. Beim nächsten Mal wird dieselbe Token-Datei für die Verbindung mit dem Google Sheets verwendet.

Die Token-Datei befindet sich unter C:\Users\<username>\AppData\Local\AutomationAnywhere\G-SuitAuth, wobei C:\Users\<username> das Nutzer-Basisverzeichnis des jeweiligen Systems ist.

Wenn Sie bei der erstmaligen Erteilung von Zugriffsberechtigungen die richtigen Anmeldedaten eingeben und eine erfolgreiche Verbindung zum Google Sheets herstellen können, brauchen Sie beim nächsten Mal, wenn nur das Passwort geändert wird, die Token-Datei nicht löschen, da sie wie erwartet funktionieren wird.

Verwenden Sie andere Aktionen aus dem gleichen Google-Paket, um Aufgaben zu automatisieren. Zur Verwendung von Aktionen aus anderen Google-Paketen stellen Sie eine Verbindung mit der Aktion Verbinden über dieses Paket her.