Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Google Drive mit Gemini Enterprise verbinden. Über 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 Console 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. Private Google-Konten (Privatnutzerkonten, die auf
@gmail.comenden) haben keine Kundennummer und werden nicht unterstützt.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.
Smarte Funktionen aktivieren: Aktivieren Sie in Ihrem Google Workspace-Konto sowohl Smarte Funktionen in Google Workspace als auch Smarte Funktionen in anderenGoogle -Produkten. Weitere Informationen finden Sie im Hilfeartikel Smarte Funktionen in Google Workspace aktivieren/deaktivieren.
OAuth-App auf die Zulassungsliste setzen (nur Administratoren): Der Google Drive-Datenspeicher verwendet eine von Googleverwaltete OAuth-App, um auf Ihre Daten zuzugreifen. Wenn Ihre Organisation den Zugriff auf OAuth-Apps einschränkt, muss Ihr Google Workspace-Administrator diese App der Zulassungsliste Ihrer Organisation hinzufügen. Weitere Informationen finden Sie unter Von Googleverwaltete OAuth-Anwendung auf die Zulassungsliste setzen.
Google Drive-Datenspeicher erstellen
So erstellen Sie den Google Drive-Datenspeicher:
Rufen Sie in der Google Google Cloud Console die Seite Gemini Enterprise auf.
Projekt auswählen oder erstellen Google Cloud .
Klicken Sie im Navigationsmenü auf Datenspeicher.
Klicken Sie auf Datenspeicher erstellen.
Suchen Sie im Abschnitt Quelle nach Google Drive und klicken Sie auf Auswählen.
Optional: Konfigurieren Sie im Abschnitt Daten Filter, um festzulegen, welche Google Drive-Inhalte im Datenspeicher durchsucht werden. Wählen Sie eine der folgenden Optionen aus, um Filter mit der Google Cloud Console oder der REST API zu konfigurieren:
Console
- Geben Sie im Feld IDs der geteilten Ablage, im Feld Ordner-IDs oder in beiden Feldern die IDs ein, nach denen Sie filtern möchten.
- Wählen Sie für jedes Feld Einschließen aus, um nur die angegebenen IDs zu durchsuchen, oder Ausschließen, um sie von der Suche auszuschließen. Konfigurieren Sie für jedes Feld entweder den Modus Einschließen oder Ausschließen, aber nicht beide.
- Wenn Sie die ID eines Ordners oder einer geteilten Ablage finden möchten, öffnen Sie den Ordner oder die geteilte Ablage in Google Drive und kopieren Sie die ID aus der URL. Die URL hat folgendes Format:
https://drive.google.com/drive/folders/ID. Beispiel:https://drive.google.com/drive/folders/123456789012345678901.
REST API
Rufen Sie zum Erstellen eines Datenspeichers mit Filtern die Methode
setUpDataConnectorauf.Einschlusslisten werden unter
admin_filterund Ausschlusslisten unteradmin_exclusion_filterfestgelegt. Füllen Sie für jeden Filtertyp die Liste unteradmin_filteroder unteradmin_exclusion_filteraus, 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": { "FILTER_TYPE": { "FILTER_KEY": [ "FILTER_VALUE_1", "FILTER_VALUE_2" ] } }, "entities": [ { "entityName": "google_drive" } ], "connectorModes": [ "FEDERATED" ] } }'
Ersetzen Sie Folgendes:
-
PROJECT_ID: Die Projekt-ID. -
ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an: usfür die Multiregion „USA“eufür die Multiregion „EU“globalfür den Standort „Global“
LOCATION: der multiregionale Standort Ihres Datenspeichers:globaloderusCOLLECTION_ID: die eindeutige ID des Datenspeichers.COLLECTION_DISPLAY_NAME: Der Anzeigename des Datenspeichers.FILTER_TYPE: Der Filtertyp, entwederadmin_filterfür den Einschluss oderadmin_exclusion_filterfür den Ausschluss. Füllen Sie die Liste unteradmin_filteroder unteradmin_exclusion_filteraus, aber nicht unter beiden.FILTER_KEY: die Drive-Entität, nach der gefiltert werden soll, entwederSharedDriveIdsoderFolderIds.FILTER_VALUE_1,FILTER_VALUE_2: Die IDs der geteilten Ablagen oder Ordner, nach denen gefiltert werden soll.Wählen Sie im Abschnitt Aktionen die Aktionen aus der Liste aus, um sie für den Google Drive-Connector zu aktivieren.
Informationen zum Verwalten der Liste der Aktionen finden Sie unter Aktionen verwalten.
Klicken Sie auf Weiter.
Im Abschnitt Konfiguration:
- Wählen Sie in der Liste Multiregional den Speicherort für den Daten-Connector aus.
- Geben Sie im Feld Name des Daten-Connectors einen Namen für den Connector ein.
- Wenn Sie
usodereuals 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 Schlüsselverwaltungstyp den entsprechenden Typ aus.
- Wählen Sie in der Liste Cloud KMS-Schlüssel den Schlüssel aus.
Optional: Geben Sie im Feld Tag eine stabile Kennung für den Datenspeicher ein. Diese Kennung wird für verschiedene Versionen des Connectors verwendet und kann nach dem Erstellen des Datenspeichers nicht mehr geändert werden. Wählen Sie daher einen Wert aus, den Sie später nicht mehr ändern müssen.
Optional: Hängen Sie im Abschnitt Sensitive Data Protection-Richtlinie eine vorhandene Sensitive Data Protection-Richtlinie an, um Daten zu prüfen und zu de-identifizieren, die Gemini Enterprise über diesen Datenspeicher abruft. Wenn Ihre Organisation keine Sensitive Data Protection-Richtlinie benötigt, können Sie diesen Schritt überspringen.
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:
- Rufen Sie den Connector aus der Liste der Datenspeicher auf und beobachten Sie den Status, bis er sich in Aktiv ändert.
- 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:
Gemini Enterprise sendet Ihre Suchanfrage an die Google Drive API.
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 Invalid 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 1 bis 63 Zeichen lang sein, mit einem Kleinbuchstaben beginnen, mit einem Kleinbuchstaben oder einer Ziffer enden und darf 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
- Wenn Sie eine Benutzeroberfläche für das Abfragen Ihrer Daten bereitstellen möchten, erstellen Sie eine App und verbinden diese mit dem Google Drive-Datenspeicher.
- Informationen zum Hinzufügen oder Aktualisieren von Ordner- und Filter für geteilte Ablagen in Ihrem Datenspeicher finden Sie unter Filter zu einem Google Drive-Datenspeicher hinzufügen.
- Um eine Vorschau darüber zu erhalten, wie Ihre Suchergebnisse aussehen, nachdem Ihre App eingerichtet ist, gehen Sie auf Suchergebnisse abrufen.
- Informationen zum Aktivieren von Benachrichtigungen für den Datenspeicher finden Sie unter Benachrichtigungen für Drittanbieter-Datenspeicher konfigurieren.
- Wenn Ihre App ursprünglich nicht so konfiguriert war, dass sie domänenübergreifende Dokumente enthält, aktivieren Sie die Funktion Domänenübergreifende Dokumente einbeziehen in den Einstellungen Web-App-Funktionen verwalten. Weitere Informationen finden Sie unter Funktionen der Webanwendung verwalten.