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 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.com) 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 anderen Google Produkten. Weitere Informationen finden Sie unter Smarte Funktionen in Google Workspace aktivieren/deaktivieren.
OAuth-App auf die Zulassungsliste setzen (nur Administratoren): Der Google Drive-Datenspeicher verwendet eine 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 auf die Zulassungsliste Ihrer Organisation setzen. Weitere Informationen finden Sie unter Googleverwaltete OAuth App 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, die den Umfang der Google Drive-Inhalte festlegen, die vom 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 Ablagen, 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 entweder den Modus Einschließen oder den Modus Ausschließen für jedes Feld, aber nicht beide.
- Wenn Sie eine Ordner-ID oder eine ID 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 die
setUpDataConnectorMethode auf, um einen Datenspeicher mit Filtern zu erstellen.Einschlusslisten werden unter
admin_filterund Ausschluss Listen werden 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: die Multiregion Ihres Datenspeichers:globaloderus.COLLECTION_ID: die eindeutige ID des Daten speichers.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 beide.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 ausgewä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.
Optional: Geben Sie im Feld Tag eine stabile ID für den Datenspeicher ein. Diese ID wird für verschiedene Versionen des Connectors verwendet und ist nach dem Erstellen des Datenspeichers unveränderlich. Wählen Sie daher einen Wert aus, den Sie später nicht ä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 in Ihrer Organisation keine Sensitive Data Protection-Richtlinie erforderlich ist, 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 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, 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 geteilten Ablagefiltern für Ihren 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 nicht von Anfang an so konfiguriert wurde, dass sie domänenübergreifende Dokumente enthält, aktivieren Sie die Funktion Domänenübergreifende Dokumente einbeziehen in den Einstellungen unter Funktionen der Webanwendung verwalten. Weitere Informationen finden Sie unter Funktionen der Webanwendung verwalten.