Google Kalender- und Gmail-Aktionen hinzufügen

Auf der folgenden Seite wird beschrieben, wie Sie Assistant-Aktionen für Google Kalender und Gmail einrichten.

Google Kalender-Aktionen

Wenn Google Kalender-Aktionen aktiviert sind, können Endnutzer den Assistant bitten, Google Kalender-Termine für sie zu erstellen.

Ein Nutzer könnte beispielsweise „Plane morgen um 15:00 Uhr ein Meeting mit user1@example.com“ eingeben. Der Assistant fragt bei Bedarf nach weiteren Details und bittet den Nutzer dann, die Erstellung des Ereignisses zu bestätigen.

Der Assistant kann die folgenden Google Kalender-Felder über Aktionen lesen und bearbeiten:

Feld	Beschreibung
Teilnehmer	Erforderlich. Liste der E‑Mail-Adressen der Teilnehmer. Der anfragende Nutzer wird der Liste automatisch hinzugefügt.
Titel	Titel der Besprechung.
Startzeit	Startzeit der Besprechung.
Dauer	Dauer der Besprechung. Der Standardwert ist 30 Minuten.
Zeitzone	Zeitzone für die Besprechung. Wenn nicht angegeben, wird die Zeitzone des Nutzers verwendet.
Beschreibung	Beschreibung der Besprechung.

Authentifizierung und Berechtigungen für Google Kalender einrichten

Bevor Google Kalender-Aktionen aktiviert werden können, muss ein Administrator von Google Cloud die Google Calendar API aktivieren und die Autorisierung so einrichten:

Google Calendar API aktivieren

Aktivieren Sie die folgenden APIs in der Google Cloud Console:

Google Calendar API: API aktivieren.
Google People API: API aktivieren.

OAuth-App erstellen und Bereiche hinzufügen

Wenn Sie keine OAuth-App haben, führen Sie die folgenden Schritte aus. Wenn Sie bereits eine OAuth-App haben, fahren Sie mit OAuth-Clientanmeldedaten erstellen fort.

Rufen Sie die Google Auth Platform / Übersicht auf.
Klicken Sie auf Jetzt starten.
Geben Sie einen Namen für die OAuth-App ein.
Geben Sie eine E‑Mail-Adresse für den Nutzersupport ein.
Wählen Sie Intern aus.
Geben Sie die Kontaktdaten des Entwicklers ein.
Klicken Sie auf Erstellen.

OAuth-Clientanmeldedaten erstellen

In dieser Anleitung wird beschrieben, wie Sie eine neue OAuth-Client-ID für Aktionen von Google Clouderstellen. Diese OAuth-Client-ID und der Clientschlüssel können auch für andere Aktionen von Google Cloudverwendet werden. Wenn Sie bereits eine Google Cloud OAuth-Client-ID für Aktionen von Google Cloudhaben, können Sie diese Client-ID und den Schlüssel für Google Kalender-Aktionen verwenden, anstatt eine neue Client-ID zu erstellen.

Rufen Sie die Google Auth Platform / Clients auf.
Klicken Sie auf Client erstellen.
Wählen Sie als Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Client-ID ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf URI hinzufügen und geben Sie den folgenden URI ein: https://vertexaisearch.cloud.google.com/oauth-redirect
Klicken Sie auf Erstellen und kopieren Sie die folgenden Informationen:
- Client-ID
- Clientschlüssel

Google Kalender-Aktion hinzufügen

So erstellen Sie eine Google Kalender-Aktion über die Console oder die API:

Hinweis

Bevor Sie eine Google Kalender-Aktion hinzufügen können, müssen Sie die erforderlichen Voraussetzungen erfüllen. Sie müssen z. B. eine vorhandene App und Authentifizierungsdetails haben.

Ein Administrator von Google Cloud muss zuerst die Schritte im Abschnitt Authentifizierung und Berechtigungen für Google Kalender einrichten ausführen und Ihnen die Client-ID und den Clientschlüssel zur Verfügung stellen, bevor Sie Aktionen hinzufügen können.
Sie benötigen eine vorhandene Gemini Enterprise-App, die mit einem Google Kalender-Datenspeicher verbunden ist. Informationen zum Erstellen einer neuen App finden Sie unter App erstellen.
Wenn Sie die Discovery Engine API vor Kurzem in Ihrem Projekt von Google Cloud aktiviert und eine App erstellt haben, warten Sie mindestens 15 Minuten, bis die Einrichtung der App abgeschlossen ist, bevor Sie Google Kalender-Aktionen konfigurieren.

Google Kalender-Aktionen konfigurieren

Console

So fügen Sie Ihrer App über die Console Aktionen hinzu:

Rufen Sie in Gemini Enterprise die Seite Gemini Enterprise auf.
Wählen Sie Ihre Gemini Enterprise-App aus.
Klicken Sie im Navigationsmenü auf Aktionen.
Aktion hinzufügen:
- Wenn dies Ihre erste Aktion ist, klicken Sie auf Aktion hinzufügen.
- Wenn Sie bereits Aktionen erstellt haben, klicken Sie auf Erstellen.
Klicken Sie für Google Kalender auf Verbinden.
Geben Sie einen Namen für den Aktions-Connector ein.
Geben Sie Autorisierungsinformationen für den Aktions-Connector ein:
1. Geben Sie für Neue Client-ID und Neuer Clientschlüssel die Client-ID und den Clientschlüssel ein, die von Ihrem Administrator im Abschnitt OAuth-Client-Anmeldedaten erstellen erstellt wurden.
2. Klicken Sie auf Authentifizieren und gewähren Sie der Gemini Enterprise-App Zugriff auf Ihren Google-Kalender.
Wählen Sie aus, welche Aktionen aktiviert werden sollen.
Klicken Sie auf Einrichtung abschließen. Ihre Aktion wird auf der Seite Aktionen angezeigt.

REST

So fügen Sie Ihrer App Aktionen über die API hinzu:

Erstellen Sie einen Aktions-Connector für die Google Kalender-Aktion.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
-d '{
  "collection_id":"CONNECTOR_ID",
  "collection_display_name":"CONNECTOR_DISPLAY_NAME",
  "data_connector":{
      "data_source":"google_calendar",
      "action_config":{
        "is_action_configured":true,
        "action_params":{
            "client_id":"CLIENT_ID",
            "client_secret":"CLIENT_SECRET"
        }
      },
      "connector_modes": ["ACTIONS"]
  }
}'

PROJECT_ID: die ID des Projekts, in dem Sie den Aktions-Connector für Google Kalender erstellen möchten.
LOCATION: Die Multiregion Ihres Aktions-Connectors für Google Kalender: global, us oder eu.
CONNECTOR_ID: die ID des Connectors, den Sie erstellen möchten. Diese ID darf nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten.
CONNECTOR_DISPLAY_NAME: der Anzeigename des Connectors, den Sie erstellen möchten.
CLIENT_ID: die Client-ID, die von Ihrem Administrator in OAuth-Client-Anmeldedaten erstellen erstellt wurde.
CLIENT_SECRET: der Clientschlüssel, der von Ihrem Administrator unter OAuth-Clientanmeldedaten erstellen erstellt wurde.

Verknüpfen Sie den von Ihnen erstellten Aktions-Connector für Google Kalender mit einer vorhandenen App.

Hinweis: Wenn für Ihre App bereits Aktionen konfiguriert sind, wird die Verknüpfung mit dem folgenden Befehl aufgehoben. Wenn Sie vorhandene Aktionen beibehalten und die Google Kalender-Aktion verknüpfen möchten, müssen Sie die Details Ihrer vorhandenen Aktionen in die API-Anfrage aufnehmen. Weitere Informationen finden Sie unter Google Kalender- und Gmail-Aktionen mit einer App verknüpfen.
```
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
  "enabled_tools": {
    "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
      "tool_info": [
        {
          "tool_name": "create_calendar_event",
          "tool_display_name": "Create Calendar Event"
        }
      ]
    }
  }
}'
```
- PROJECT_ID: die ID des Projekts, in dem sich Ihre App und der Aktions-Connector für Google Kalender befinden.
- LOCATION: die Multiregion Ihrer App und Ihres Aktions-Connectors: global, us oder eu.
- APP_ID: die ID der App, der Sie die Aktion zuweisen möchten.
- CONNECTOR_ID: die ID des Aktions-Connectors für Google Kalender, der im vorherigen Schritt erstellt wurde.

Nachdem Sie Aktionen hinzugefügt haben, kann der Assistant diese Aktionen im Namen Ihrer Endnutzer in der App ausführen. Wenn ein Nutzer den Assistant zum ersten Mal bittet, eine Google Kalender-Aktion auszuführen, wird er aufgefordert, den Zugriff auf sein Google Kalender-Konto zu autorisieren.

Gmail-Aktionen

Wenn Gmail-Aktionen aktiviert sind, können Endnutzer den Assistant bitten, E‑Mails für sie zu senden.

Ein Nutzer könnte beispielsweise eingeben: „Sende eine E-Mail an nutzer1@beispiel.de mit dem Titel ‚Hallo‘ und dem Inhalt ‚Wie geht es dir?‘“. Der Assistant fragt bei Bedarf nach zusätzlichen Details und fordert den Nutzer dann auf, das Senden der E‑Mail zu bestätigen.

Der Assistant kann die folgenden Gmail-Felder über Aktionen lesen und bearbeiten:

Feld	Beschreibung
An	Erforderlich. E‑Mail-Liste der Empfänger.
Betreff	Erforderlich. E‑Mail-Betreff
Inhalt	Erforderlich. Inhalte der E‑Mail im Markdown-Format.
CC	Die CC-Liste der E‑Mail.
BCC	Die BCC-Liste der E‑Mail.

Authentifizierung und Berechtigungen für Gmail einrichten

Bevor Gmail-Aktionen aktiviert werden können, muss ein Administrator von Google Cloud die Gmail API aktivieren und die Autorisierung einrichten.

Gmail API aktivieren

Aktivieren Sie die folgenden APIs in der Google Cloud Console:

Gmail API: API aktivieren.
Google People API: API aktivieren.

OAuth-App erstellen und Bereiche hinzufügen

Wenn Sie keine OAuth-App haben, führen Sie die folgenden Schritte aus. Wenn Sie bereits eine OAuth-App haben, fahren Sie mit OAuth-Clientanmeldedaten erstellen fort.

Rufen Sie die Google Auth Platform / Übersicht auf.
Klicken Sie auf Jetzt starten.
Geben Sie einen Namen für die OAuth-App ein.
Geben Sie eine E‑Mail-Adresse für den Nutzersupport ein.
Wählen Sie Intern aus.
Geben Sie die Kontaktdaten des Entwicklers ein.
Klicken Sie auf Erstellen.

OAuth-Clientanmeldedaten erstellen

Rufen Sie die Google Auth Platform / Clients auf.
Klicken Sie auf Client erstellen.
Wählen Sie als Anwendungstyp die Option Webanwendung aus.
Geben Sie im Feld Name einen Namen für Ihre Client-ID ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf URI hinzufügen und geben Sie den folgenden URI ein: https://vertexaisearch.cloud.google.com/oauth-redirect
Klicken Sie auf Erstellen und kopieren Sie die folgenden Informationen:
- Client-ID
- Clientschlüssel

Gmail-Aktion hinzufügen

Mit den folgenden Schritten erstellen Sie eine Gmail-Aktion über die Console oder die API.

Hinweis

Bevor Sie eine Gmail-Aktion hinzufügen können, müssen Sie die erforderlichen Voraussetzungen erfüllen. Sie müssen z. B. eine vorhandene App und Authentifizierungsdetails haben.

Ein Administrator von Google Cloud muss zuerst die Schritte im Abschnitt Authentifizierung und Berechtigungen für Gmail einrichten ausführen und Ihnen die Client-ID und den Clientschlüssel zur Verfügung stellen, bevor Sie Aktionen hinzufügen können.
Sie benötigen eine vorhandene Gemini Enterprise-App, die mit einem Gmail-Datenspeicher verbunden ist. Informationen zum Erstellen einer neuen App finden Sie unter App erstellen.
Wenn Sie die Discovery Engine API vor Kurzem in Ihrem Projekt von Google Cloud aktiviert und eine App erstellt haben, warten Sie mindestens 15 Minuten, bis die Einrichtung der App abgeschlossen ist, bevor Sie Gmail-Aktionen konfigurieren.

Gmail-Aktionen konfigurieren

Console

So fügen Sie Ihrer App über die Console Aktionen hinzu:

Rufen Sie in Gemini Enterprise die Seite Gemini Enterprise auf.
Wählen Sie Ihre Gemini Enterprise-App aus.
Klicken Sie im Navigationsmenü auf Aktionen.
Aktion hinzufügen:
- Wenn dies Ihre erste Aktion ist, klicken Sie auf Aktion hinzufügen.
- Wenn Sie bereits Aktionen erstellt haben, klicken Sie auf Erstellen.
Klicken Sie für Gmail auf Verbinden.
Geben Sie einen Namen für den Aktions-Connector ein.
Geben Sie Autorisierungsinformationen für den Aktions-Connector ein:
1. Geben Sie für Neue Client-ID und Neuer Clientschlüssel die Client-ID und den Clientschlüssel ein, die von Ihrem Administrator im Abschnitt OAuth-Client-Anmeldedaten erstellen erstellt wurden.
2. Klicken Sie auf Authentifizieren und gewähren Sie der Gemini Enterprise-App Zugriff auf Ihr Gmail-Konto.
Wählen Sie aus, welche Aktionen aktiviert werden sollen.
Klicken Sie auf Einrichtung abschließen. Ihre Aktion wird auf der Seite Aktionen angezeigt.

REST

So fügen Sie Ihrer App Aktionen über die API hinzu:

Erstellen Sie einen Aktions-Connector für die Gmail-Aktion.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
-d '{
  "collection_id":"CONNECTOR_ID",
  "collection_display_name":"CONNECTOR_DISPLAY_NAME",
  "data_connector":{
      "data_source":"gmail",
      "action_config":{
        "is_action_configured":true,
        "action_params":{
            "client_id":"CLIENT_ID",
            "client_secret":"CLIENT_SECRET"
        }
      },
      "connector_modes": ["ACTIONS"]
  }
}'

PROJECT_ID: Die ID des Projekts, in dem Sie den Gmail-Aktions-Connector erstellen möchten.
LOCATION: Die Multiregion Ihres Gmail-Aktions-Connectors: global, us oder eu.
CONNECTOR_ID: die ID des Connectors, den Sie erstellen möchten. Diese ID darf nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten.
CONNECTOR_DISPLAY_NAME: der Anzeigename des Connectors, den Sie erstellen möchten.
CLIENT_ID: die Client-ID, die von Ihrem Administrator in OAuth-Client-Anmeldedaten erstellen erstellt wurde.
CLIENT_SECRET: der Clientschlüssel, der von Ihrem Administrator unter OAuth-Clientanmeldedaten erstellen erstellt wurde.

Verknüpfen Sie den von Ihnen erstellten Gmail-Aktions-Connector mit einer vorhandenen App.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
  "enabled_tools": {
    "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
      "tool_info": [
        {
          "tool_name": "send_email",
          "tool_display_name": "Send Email"
        }
      ]
    }
  }
}'

PROJECT_ID: die ID des Projekts, in dem sich Ihre App und der Gmail-Aktions-Connector befinden.
LOCATION: Die Multiregion Ihrer App und Ihres Connectors: global, us oder eu.
APP_ID: die ID der App, der Sie die Aktion zuweisen möchten.
CONNECTOR_ID: die ID des Gmail-Aktions-Connectors, der im vorherigen Schritt erstellt wurde.

Nachdem Sie Aktionen hinzugefügt haben, kann der Assistant diese Aktionen im Namen Ihrer Endnutzer in der App ausführen. Wenn ein Nutzer den Assistant zum ersten Mal auffordert, eine Gmail-Aktion auszuführen, wird er aufgefordert, den Zugriff auf sein Gmail-Konto zu autorisieren.

Google Kalender- und Gmail-Aktionen mit einer App verknüpfen

Die folgende API-Anfrage zeigt, wie Sie Google Kalender- und Gmail-Aktionen mit einer vorhandenen App verknüpfen.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
   "name":"projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
   "enabled_tools":{
      "projects/PROJECT_ID/locations/LOCATION/collections/GMAIL_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"send_email",
               "tool_display_name":"Send Email"
            }
         ]
      },
      "projects/PROJECT_ID/locations/LOCATION/collections/CALENDAR_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"create_calendar_event",
               "tool_display_name":"Create Calendar Event"
            }
         ]
      }
    }
  }'

PROJECT_ID: Die ID des Projekts, in dem sich Ihre App und die Google Kalender- und Gmail-Aktions-Connectors befinden.
LOCATION: Die Multiregion Ihrer App und Connectors: global, us oder eu.
APP_ID: die ID der App, der Sie die Aktion zuweisen möchten.
CALENDAR_CONNECTOR_ID: die ID des Aktions-Connectors für Google Kalender, der im vorherigen Schritt erstellt wurde.
GMAIL_CONNECTOR_ID: die ID des Gmail-Aktions-Connectors, der im vorherigen Schritt erstellt wurde.

Nachdem Sie Aktionen hinzugefügt haben, kann der Assistant diese Aktionen im Namen Ihrer Endnutzer in der App ausführen. Wenn ein Nutzer den Assistant zum ersten Mal bittet, eine Google Kalender- oder Gmail-Aktion auszuführen, wird er aufgefordert, den Zugriff auf sein Konto zu autorisieren.

Google Kalender- und Gmail-Aktionen hinzufügen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Google Kalender-Aktionen

Authentifizierung und Berechtigungen für Google Kalender einrichten

Google Calendar API aktivieren

OAuth-App erstellen und Bereiche hinzufügen

OAuth-Clientanmeldedaten erstellen

Google Kalender-Aktion hinzufügen

Hinweis

Google Kalender-Aktionen konfigurieren

Console

REST

Gmail-Aktionen

Authentifizierung und Berechtigungen für Gmail einrichten

Gmail API aktivieren

OAuth-App erstellen und Bereiche hinzufügen

OAuth-Clientanmeldedaten erstellen

Gmail-Aktion hinzufügen

Hinweis

Gmail-Aktionen konfigurieren

Console

REST

Google Kalender- und Gmail-Aktionen mit einer App verknüpfen

Google Kalender- und Gmail-Aktionen hinzufügen