Google Drive-Datenspeicher einrichten

Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Google Drive mit Gemini Enterprise verbinden. Durch diese Verbindung kann Gemini Enterprise Informationen direkt aus Google Drive abrufen. Da keine Daten in den Gemini Enterprise-Index kopiert werden, müssen Sie sich nicht um den Datenspeicher kümmern.

Hinweis

  • Sie müssen in der Google Cloud Konsole mit demselben Konto angemeldet sein, das Sie für die Google Drive-Instanz verwenden, die Sie verbinden möchten. Gemini Enterprise verwendet Ihre Google Workspace-Kunden-ID, um eine Verbindung zu Google Drive 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.

  • Achten Sie darauf, dass die Dokumente zugänglich sind, indem Sie diese entweder in einer geteilten Ablage platzieren, die der Domain gehört, oder die Inhaberschaft einem Nutzer in der Domain zuweisen.

  • Aktivieren Sie die smarten Google Workspace-Funktionen in anderen Google-Produkten, um Google Drive-Daten mit Gemini Enterprise zu verbinden. Weitere Informationen finden Sie unter Smarte Funktionen in Google Workspace aktivieren/deaktivieren.

Google Drive-Datenspeicher erstellen

So erstellen Sie den Google Drive-Datenspeicher:

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

    Gemini Enterprise

  2. Projekt auswählen oder erstellen Google Cloud .

  3. Klicken Sie im Navigationsmenü auf Datenspeicher.

  4. Klicken Sie auf Datenspeicher erstellen.

  5. Suchen Sie im Bereich Quelle nach Google Drive und klicken Sie auf Auswählen.

  6. Geben Sie im Bereich Daten die Drive-Quelle für den Datenspeicher an. Sie können Filter konfigurieren, mit denen der Umfang der Google Drive-Inhalte festgelegt wird, die indexiert werden mit der Google Cloud Console oder der API:

    Console

    1. Wählen Sie die Drive-Quelle für den Datenspeicher aus:
      • Alle: Alle Drives im Arbeitsbereich werden dem Datenspeicher hinzugefügt.
      • Ordnerfilter: Die Suche wird auf eine bestimmte Gruppe von Ordnern beschränkt. Wählen Sie Einschließen aus, um die Suche auf die aufgeführten Ordner zu beschränken, oder Ausschließen , um die aufgeführten Ordner aus der Suche zu entfernen. Fügen Sie dann eine oder mehrere Ordner-IDs hinzu.
      • Filter für geteilte Ablagen: Die Suche wird auf eine bestimmte Gruppe von geteilten Ablagen beschränkt. Wählen Sie Einschließen aus, um die Suche auf die aufgeführten geteilten Ablagen zu beschränken, oder Ausschließen , um die aufgeführten geteilten Ablagen aus der Suche zu entfernen. Fügen Sie dann eine oder mehrere IDs für geteilte Ablagen hinzu.
    2. Konfigurieren Sie für jeden Filtertyp den Modus Einschließen oder Ausschließen, aber nicht beide.
    3. Wenn Sie eine Ordner-ID oder eine ID für eine geteilte Ablage finden möchten, rufen Sie den Ordner oder die geteilte Ablage in Google Drive auf und kopieren Sie die ID aus der URL. Die URL hat folgendes Format: https://drive.google.com/corp/drive/folders/ID. Beispiel: https://drive.google.com/corp/drive/folders/123456789012345678901.

    REST

    Rufen Sie die setUpDataConnector Methode auf, um einen Datenspeicher mit Filtern zu erstellen.

    Einschlusslisten werden unter admin_filter und Ausschluss Listen werden unter admin_exclusion_filter festgelegt. Füllen Sie für jeden Filtertyp die Liste unter admin_filter oder unter admin_exclusion_filter aus, aber nicht beide.

    
   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       -H "X-Goog-User-Project: PROJECT_ID" \
       "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
       -d '{
         "collectionId":"COLLECTION_ID",
         "collectionDisplayName":"COLLECTION_DISPLAY_NAME",
         "dataConnector":{
           "dataSource":"google_drive",
           "params":{
             "admin_filter":{
               "SharedDriveIds": INCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": INCLUDED_FOLDER_IDS
             },
             "admin_exclusion_filter":{
               "SharedDriveIds": EXCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": EXCLUDED_FOLDER_IDS
             }
           },
           "entities":[
             {
               "entityName":"drive"
             }],
           "connectorModes":[
             "FEDERATED"
             ]
         }
       }'

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Ihre Projekt-ID.
    • ENDPOINT_LOCATION: Die Region Ihrer Anwendung. Beispiel: us oder eu.
    • LOCATION: Der multiregionale Standort Ihres Datenspeichers: global oder us.
    • COLLECTION_ID: Die eindeutige ID des Datenspeichers.
    • COLLECTION_DISPLAY_NAME: Der Anzeigename des Datenspeichers.
    • INCLUDED_SHARED_DRIVE_IDS: Eine Liste der IDs von geteilten Ablagen, die in die Suche einbezogen werden sollen, z. B. ["0ABCdEfGhIjKlMnOpQ"]. Verwenden Sie eine leere Liste [], wenn Sie keine Einschlussliste für geteilte Ablagen festlegen.
    • INCLUDED_FOLDER_IDS: Eine Liste der Ordner-IDs, die in die Suche einbezogen werden sollen, z. B. ["1AbCdEfGhIjKlMnOpQrStUvWxYz"]. Verwenden Sie eine leere Liste [], wenn Sie keine Einschlussliste für Ordner festlegen.
    • EXCLUDED_SHARED_DRIVE_IDS: Eine Liste der IDs von geteilten Ablagen, die von der Suche ausgeschlossen werden sollen. Verwenden Sie eine leere Liste [], wenn Sie keine Ausschlussliste für geteilte Ablagen festlegen.
    • EXCLUDED_FOLDER_IDS: Eine Liste der Ordner-IDs, die von der Suche ausgeschlossen werden sollen. Verwenden Sie eine leere Liste [], wenn Sie keine Ausschlussliste für Ordner festlegen.

    Weitere Informationen zu Filtertypen und zum Hinzufügen von Filtern finden Sie unter Filter zu einem Google Drive-Datenspeicher hinzufügen.

  7. Klicken Sie auf Weiter.

  8. Im Abschnitt Konfiguration:

    1. Wählen Sie in der Liste Multiregional 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 gewählt haben, konfigurieren Sie die Verschlüsselungseinstellungen:
      • Wählen Sie Googleverwalteter Verschlüsselungsschlüssel oder Cloud KMS-Schlüssel aus.
      • Falls Sie Cloud KMS-Schlüssel ausgewählt haben:
        • Wählen Sie in der Liste Typ der Schlüsselverwaltung 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 die Option 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.

So prüfen Sie den Status des Datenspeichers:

  1. Rufen Sie den Connector aus der Liste der Datenspeicher auf und beobachten Sie den Status, bis er sich in Aktiv ändert.
  2. Sobald sich der Status des Datenspeichers von Wird erstellt zu Aktiv ändert, ist der Google Drive-Connector einsatzbereit.

Nachdem Sie den Datenspeicher erstellt haben, erstellen Sie eine App und verknüpfen diese mit dem Google Drive-Datenspeicher, bevor Sie die Abfrage ausführen.

Ausführung von Abfragen

Nachdem Sie Google Drive autorisiert haben, passiert Folgendes, wenn Sie eine Suchanfrage eingeben:

  1. Gemini Enterprise sendet Ihre Suchanfrage an die Google Drive API.

  2. Gemini Enterprise kombiniert die Ergebnisse mit denen aus anderen Quellen und zeigt sie an.

Fehlermeldungen und Fehlerbehebung

In der folgenden Tabelle werden Fehlermeldungen beschrieben, die beim Arbeiten mit dieser Google -Datenquelle auftreten können. Die Tabelle enthält HTTP-Fehlercodes und Vorschläge zur Fehlerbehebung.

Fehlercode Fehlermeldung Beschreibung Fehlerbehebung
403 Berechtigung verweigert 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 Berechtigung verweigert 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 Berechtigung verweigert 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 Nutzer und Google Workspace-Datenspeicher in verschiedenen Organisationen sein sollen.
403 Berechtigung verweigert Der Workspace-Zugriff für Agentspace 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.
400 Ungültiges Argument Die Anfrage enthält ein ungültiges Argument. Dieser Fehler tritt auf, wenn der Name des Daten-Connectors in der Anfrage nicht den Namensanforderungen entspricht. Prüfen Sie den Namen des Daten-Connectors. Er muss zwischen 1 und 63 Zeichen lang sein, mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden. Außerdem darf er nur Kleinbuchstaben, Ziffern, Bindestriche oder Unterstriche enthalten. Verwenden Sie beispielsweise einen Namen wie cymbal-collection-123456789 anstelle von 123456789-cymbal-collection.

Informationen zu häufigen Suchproblemen, die beim Abfragen Ihrer Google Drive-Daten auftreten können, finden Sie unter Häufige Suchprobleme.

Nächste Schritte