Microsoft OneDrive-Datenspeicher einrichten

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

Hinweis

Prüfen Sie vor dem Einrichten der Microsoft OneDrive-Verbindung Folgendes:

  1. Weisen Sie dem Nutzer die Rolle „Discovery Engine Editor“ (roles/discoveryengine.editor) zu. Diese Rolle ist erforderlich, damit der Nutzer den Datenspeicher erstellen kann. So weisen Sie diese Rolle zu:

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

      IAM aufrufen

    2. Suchen Sie das Nutzerkonto und klicken Sie auf „Bearbeiten“ „Bearbeiten“.
    3. Weisen Sie dem Nutzer die Rolle Discovery Engine Editor zu. Weitere Informationen finden Sie unter IAM-Rollen und -Berechtigungen.

  2. Registrieren Sie Gemini Enterprise als OAuth 2.0-Anwendung in Microsoft Entra ID und erfassen Sie die folgenden Anmeldedaten:

    • Client-ID

    • Clientschlüssel

    • Mandanten-ID

  3. Konfigurieren Sie die Anwendungsberechtigungen der Microsoft API mit der Einwilligung eines Microsoft OneDrive-Administrators.

Microsoft OneDrive-Datenspeicher erstellen

So erstellen Sie einen Microsoft OneDrive-Datenspeicher:

  1. Rufen Sie in der 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 Microsoft OneDrive und klicken Sie auf Auswählen.

  6. Im Bereich Daten:

    1. Wählen Sie im Abschnitt Connector-Modus als Verbindungsmodus Datenaufnahme oder Föderierte Suche aus.

    2. Klicken Sie auf Weiter.

    3. Konfigurieren Sie im Abschnitt Authentifizierungseinstellungen die Authentifizierung basierend auf dem ausgewählten Verbindungsmodus.

      1. Geben Sie die folgenden Authentifizierungsdetails an:
        • Client-ID: Die eindeutige Kennung der Anwendung, die in der Microsoft Entra ID Ihrer Organisation registriert ist.
        • Clientschlüssel: Der geheime Schlüssel, der während der Registrierung der OAuth 2.0-Anwendung in Microsoft Entra ID generiert wurde.

        • Mandanten-ID: Die eindeutige Kennung für Ihre Organisation im Microsoft Entra Admin Center. Weitere Informationen finden Sie unter Client-Anmeldedaten abrufen.

        • Microsoft OneDrive-Umgebungstyp:Wählen Sie die Umgebung aus, in der Ihr Microsoft 365-Mandant gehostet wird:

          • Wählen Sie Standard (Standardeinstellung) aus, wenn Sie eine Verbindung zu Microsoft 365 für Unternehmen oder Government Community Cloud (GCC) herstellen.
          • Wählen Sie US Government aus, wenn Sie eine Verbindung zu einer Microsoft 365 US Government Sovereign Cloud (GCC High oder DoD) herstellen.

      • Wenn Sie Datenaufnahme mit der Authentifizierungsmethode Föderierte Anmeldedaten gewählt haben, kopieren Sie die Subjekt-ID und verwenden diese, um föderierte Anmeldedaten für die Datenerfassung hinzuzufügen.

        • Subjekt-ID: Die eindeutige ID des Dienstkontos, das Sie verwenden möchten.

      • Wenn Sie Föderierte Suche ausgewählt haben, klicken Sie auf Anmelden und schließen Sie die Microsoft-Anmeldung ab.

    4. Klicken Sie auf Weiter.

    5. Wenn Sie Föderierte Suche ausgewählt haben, gehen Sie so vor:

      1. Geben Sie im Bereich Ziele die Basis-URL für Ihre Microsoft OneDrive-Website ein.

      2. Im Abschnitt Erweiterte Optionen :

        1. Wählen Sie Ihre Microsoft 365 Cloud-Umgebung:
          • Wenn Sie eine Verbindung zu einer Microsoft 365 US Government-Instanz herstellen, wählen Sie die entsprechende Option aus: GCC, GCC High oder DoD.
          • Behalten Sie andernfalls die Standardeinstellung Global bei.
        2. Geben Sie unter Azure-Mandant die Mandanten-ID ein, die Sie beim Erstellen der Entra-Anwendung erhalten haben.

        3. Sie können den Umfang Ihrer Suchanfragen und Aktionen eingrenzen, indem Sie angeben, welche Microsoft OneDrive-Pfade ein- oder ausgeschlossen werden sollen. Sie können Daten nur innerhalb der eingeschlossenen Pfade ändern oder abrufen. Anfragen für Daten außerhalb des Umfangs schlagen entweder fehl oder geben keine Ergebnisse zurück.

          Sie können dem Datenspeicher Filter über die Google Cloud Console oder die API hinzufügen:

          Console

          Hinweis: Wenn Sie mehrere Websites eingeben, trennen Sie die URLs durch Kommas. Sie können auch eine Liste von URLs direkt aus einer CSV-Datei kopieren und einfügen.

          1. Im Abschnitt „Pfadfilter“:
            • Wählen Sie den Filtertyp aus: In Suche einschließen oder Von Suche ausschließen.
            • Geben Sie im Feld Pfadfilter die vollständigen OneDrive-Pfade ein.

              Hinweis: Dieses Feld unterstützt Unterpfade, Ordner und Dokumentbibliotheken im Format https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. Alle Inhalte unter dem angegebenen Pfad werden gefiltert.

          REST

          Rufen Sie die setUpDataConnector Methode auf, um beim Erstellen eines Datenspeichers Filter hinzuzufügen.

          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": "sharepoint_federated_search",
            "params": {
            "client_id": "CLIENT_ID",
            "client_secret": "CLIENT_SECRET",
            "instance_uri": "INSTANCE_URI",
            "tenant_id": "TENANT_ID",
            "FILTER_TYPE": {
                "FILTER_KEY": [
                "FILTER_VALUE1",
                "FILTER_VALUE2"
                ]
            }
            },
            "entities": [
            {
                "entityName": "file"
            }
            ],
            "refreshInterval": "7200s",
            "connectorType": "THIRD_PARTY_FEDERATED",
            "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:
          • us für die Multiregion „USA“
          • eu für die Multiregion „EU“
          • global für den Standort „Global“
          Weitere Informationen finden Sie unter Festlegen multiregionaler Standorte für Ihren Datenspeicher.
        4. LOCATION: Der multiregionale Standort Ihres Datenspeichers: global, us oder eu.
        5. COLLECTION_ID: Die eindeutige ID des Datenspeichers.
        6. COLLECTION_DISPLAY_NAME: Der Anzeigename des Datenspeichers.
        7. CLIENT_ID: Die Client-ID für die Microsoft OneDrive Authentifizierung.
        8. CLIENT_SECRET: Der Clientschlüssel für die Microsoft OneDrive-Authentifizierung.
        9. INSTANCE_URI: Der Instanz-URI für Microsoft OneDrive.
        10. TENANT_ID: Die Mandanten-ID für Microsoft OneDrive.
        11. FILTER_TYPE: Der Typ des Filters, der Ihren Microsoft OneDrive-Datenspeichern hinzugefügt wurde. Weitere Informationen finden Sie unter Filtertypen.
        12. FILTER_KEY: Der Schlüssel für den Filter, der einem Feld in Ihren Daten entspricht. Weitere Informationen finden Sie unter Filterschlüssel.
        13. FILTER_VALUES: Der Wert oder die Werte, nach denen für den angegebenen FILTER_KEY gefiltert werden soll.