Gmail-Datenspeicher einrichten

Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Gmail mit Gemini Enterprise verbinden.

Hinweise

  • Melden Sie sich in der Google Cloud Console mit demselben Konto an, das Sie für die Google Workspace-Instanz verwenden, die Sie verbinden möchten. Vertex AI Search verwendet Ihre Google Workspace-Kunden-ID, um eine Verbindung zu Gmail herzustellen.

  • Wenn Sie die Zugriffssteuerung für Datenquellen erzwingen und Daten in Gemini Enterprise schützen möchten, müssen Sie Ihren Identitätsanbieter konfigurieren.

  • Bevor Sie dem Gmail-Datenspeicher Aktionen hinzufügen können, muss ein Google Cloud Administrator zuerst die Schritte im Abschnitt Authentifizierung und Berechtigungen für Gmail einrichten ausführen, um die OAuth 2.0-Authentifizierung zu konfigurieren und Ihnen die Client-ID und den Clientschlüssel zur Verfügung zu stellen und Mindestberechtigungen einzurichten.

Gmail-Datenspeicher erstellen

So erstellen Sie den Gmail-Datenspeicher:

  1. Rufen Sie in der Google Google Cloud Console die Seite „Gemini Enterprise“ auf.

    Gemini Enterprise

  2. Wählen Sie ein Google Cloud -Projekt aus oder erstellen Sie eines.

  3. Klicken Sie im Navigationsmenü auf Datenspeicher.

  4. Klicken Sie auf das Pluszeichen Datenspeicher erstellen.

  5. Suchen Sie unter Quelle nach Gmail und klicken Sie auf Auswählen.

  6. Im Bereich Aktionen:

    1. Geben Sie die Client-ID und den Clientschlüssel ein, die Sie von der OAuth 2.0-Anwendung erhalten haben, und klicken Sie dann auf Authentifizierung bestätigen.

      Informationen zum Abrufen der Client-ID und des Clientschlüssels finden Sie unter OAuth-Clientanmeldedaten erstellen. Informationen zu den erforderlichen Bereichen für die Suche und Aktionen finden Sie unter Erforderliche Bereiche.

    2. Optional: Erweitern Sie Erweiterte Einstellungen und geben Sie den Dienstnamen ein, den Ressourcennamen des in Service Directory erstellten Dienstes. Dieses Feld ist erforderlich, wenn VPC Service Controls aktiviert ist.

    3. Wählen Sie die Aktionen aus der Liste aus, um sie für den Gmail-Connector zu aktivieren.

    Eine Liste der Aktionen finden Sie unter Aktionen ansehen.

  7. Klicken Sie auf Weiter.

  8. Im Abschnitt Konfiguration:

    1. Wählen Sie in der Liste Mehrere Regionen den Speicherort für den Daten-Connector aus.
    2. Geben Sie im Feld Name des Daten-Connectors einen Namen für den Connector ein.
    3. Wenn Sie US oder EU als Speicherort ausgewählt haben, konfigurieren Sie die Verschlüsselungseinstellungen:
      • Wählen Sie Google-verwalteter Verschlüsselungsschlüssel oder Cloud KMS-Schlüssel aus.
      • Wenn Sie Cloud KMS-Schlüssel ausgewählt haben:
        • Wählen Sie in der Liste Schlüsselverwaltungstyp den entsprechenden Typ aus.
        • Wählen Sie in der Liste Cloud KMS-Schlüssel den Schlüssel aus.
      Weitere Informationen finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel.

  9. Klicken Sie auf Weiter.

  10. Wählen Sie im Bereich Abrechnung die Option Allgemeine Preise oder Konfigurierbare Preise aus. Weitere Informationen finden Sie unter Abrechnungsstatus Ihrer Projekte prüfen und Lizenzen.

  11. Klicken Sie auf Erstellen. Gemini Enterprise erstellt den Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

Klicken Sie auf der Seite Datenspeicher auf den Namen des Datenspeichers, um den Status zu sehen. Wenn sich der Status des Datenspeichers von Wird erstellt zu Aktiv ändert, ist der Gmail-Connector einsatzbereit.

Nachdem Sie den Datenspeicher erstellt haben, erstellen Sie eine App und verbinden Sie sie mit dem Gmail-Datenspeicher, bevor Sie die Abfrage ausführen.

Abfrageausführung

In diesem Abschnitt wird beschrieben, wie Gemini Enterprise Ihre Anfrage verarbeitet und welche Auswirkungen die Verwendung des föderierten Datenspeichers auf den Datenschutz hat.

Nachdem Sie Gmail autorisiert und eine Suchanfrage an Gemini Enterprise gesendet haben, passiert Folgendes:

  • Gemini Enterprise sendet Ihre Suchanfrage direkt an die Gmail API.
  • Gemini Enterprise kombiniert die Ergebnisse mit denen aus anderen verbundenen Datenquellen und zeigt ein umfassendes Suchergebnis an.

Fehlermeldungen und Fehlerbehebung

In der folgenden Tabelle werden häufig auftretende Fehlermeldungen beschrieben, die beim Arbeiten mit dem Gmail-Connector auftreten können. Sie enthält mögliche HTTP-Fehlercodes und Vorschläge zur Fehlerbehebung.

Fehlercode Fehlermeldung Beschreibung Fehlerbehebung
403 (Permission Denied) Die Suche mit Dienstkonto-Anmeldedaten wird für Google Workspace-Datenspeicher nicht unterstützt. Die Engine, in der gesucht wird, enthält Google Workspace-Datenspeicher und die übergebenen Anmeldedaten gehören zu einem Dienstkonto. Die Suche mit Dienstkonto-Anmeldedaten in Google Workspace-Datenspeichern wird nicht unterstützt. Rufen Sie die Suche mit Nutzeranmeldedaten auf oder entfernen Sie die Google Workspace-Datenspeicher aus der Engine.
403 (Permission Denied) Privatnutzerkonten werden für Google Workspace-Datenspeicher nicht unterstützt. Die Suche wird mit Anmeldedaten eines Privatnutzerkontos (@gmail.com) aufgerufen, was für Google Workspace-Datenspeicher nicht unterstützt wird. Entfernen Sie die Google Workspace-Datenspeicher aus der Engine oder verwenden Sie ein verwaltetes Google-Konto.
403 (Permission Denied) Kundennummer passt nicht zum Datenspeicher Die Suche darf nur von Nutzern verwendet werden, die derselben Organisation wie die Google Workspace-Datenspeicher angehören. Entfernen Sie Google Workspace-Datenspeicher aus der Engine oder wenden Sie sich an den Support, wenn der Nutzer und Google Workspace-Datenspeicher in verschiedenen Organisationen sein sollen.
403 (Permission Denied) Der Workspace-Zugriff für Agent Space wurde vom Administrator der Organisation deaktiviert. Ein Google Workspace-Administrator hat den Zugriff auf Google Workspace-Daten für Gemini Enterprise deaktiviert. Wenden Sie sich an Ihren Google Workspace-Administrator, um den Zugriff zu aktivieren.

Nächste Schritte