Microsoft OneDrive データストアを設定する

このページでは、データストアを作成して Microsoft OneDrive を Gemini Enterprise に接続する方法について説明します。

始める前に

Microsoft OneDrive 接続を設定する前に、次のことを完了してください。

  1. ディスカバリー エンジン編集者ロール（roles/discoveryengine.editor）を付与します。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。

    1. Google Cloud コンソールで、[IAM] ページに移動します。

      [IAM] に移動

    2. ユーザー アカウントを見つけて、edit 編集をクリックします。
    3. ユーザーに Discovery Engine Editor ロールを付与します。詳細については、IAM のロールと権限をご覧ください。

  2. Gemini Enterprise を Microsoft Entra ID で OAuth 2.0 アプリケーションとして登録し、次の認証情報を収集します。

    • クライアント ID

    • クライアント シークレット

    • テナント ID

  3. Microsoft OneDrive 管理者の同意を得て、Microsoft API アプリケーション権限を構成します。

Microsoft OneDrive データストアを作成する

Microsoft OneDrive のデータストアを作成する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. Google Cloud プロジェクトを選択するか作成します。

  3. ナビゲーション メニューで [データストア] をクリックします。

  4. [データストアを作成] をクリックします。

  5. [ソース] セクションで「Microsoft OneDrive」を検索し、[選択] をクリックします。

  6. [データ] セクションで、次の操作を行います。

    1. [コネクタモード] セクションで、接続モードとして [データの取り込み] または [連携検索] を選択します。

    2. [続行] をクリックします。

    3. [認証の設定] セクションで、選択した接続モードに基づいて認証を構成します。

      1. 次の認証情報を入力します。
        • クライアント ID: 組織の Microsoft Entra ID に登録されているアプリケーションの固有識別子。
        • クライアント シークレット: Microsoft Entra ID での OAuth 2.0 アプリケーション登録プロセスで生成された秘密鍵。

        • テナント ID: Microsoft Entra 管理センターでの組織の固有識別子。詳細については、クライアント認証情報を取得するをご覧ください。

        • Microsoft OneDrive 環境タイプ: Microsoft 365 テナントをホストする環境を選択します。

          • 標準の商用 Microsoft 365 または Government Community Cloud（GCC）に接続する場合は、[Standard]（デフォルト）を選択します。
          • Microsoft 365 US Government ソブリン クラウド（GCC High または DoD）に接続する場合は、[US Government] を選択します。

      • フェデレーション認証情報認証方法で [データの取り込み] を選択した場合は、サブジェクト識別子をコピーして、データの取り込み用のフェデレーション認証情報を追加します。

        • サブジェクト識別子: 使用するサービス アカウントの一意の ID。

      • [連携検索] を選択した場合は、[ログイン] をクリックして Microsoft へのログインを完了します。

    4. [続行] をクリックします。

    5. [連携検索] を選択した場合は、次の操作を行います。

      1. [宛先] セクションで、Microsoft OneDrive サイトのベース URL を入力します。

      2. [詳細オプション] で、次の操作を行います。

        1. Microsoft 365 クラウド環境を選択します。
          • Microsoft 365 US Government インスタンスに接続する場合は、[GCC]、[GCC High]、[DoD] のいずれかを選択します。
          • それ以外の場合は、デフォルトの [Global] のままにします。
        2. Entra アプリケーションの作成時に取得したテナント ID である Azure テナントを入力します。

        3. 含める Microsoft OneDrive パスと除外する Microsoft OneDrive パスを指定して、検索とアクションの範囲を絞り込むことができます。含まれるパス内のデータのみを変更または取得できます。範囲外のデータのリクエストは失敗するか、結果を返しません。

          Google Cloud コンソールまたは API を使用して、データストアにフィルタを追加できます。

          Console

          注: 複数のサイトを入力する場合は、各 URL をカンマで区切ります。CSV ファイルから URL のリストを直接コピーして貼り付けることもできます。

          1. [パスフィルタ] セクションで次の操作を行います。
            • フィルタの種類（[検索に含める] または [検索から除外する]）を選択します。
            • [パスフィルタ] フィールドに、OneDrive のフルパスを入力します。

              注: このフィールドは、https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/ 形式のサブパス、フォルダ、ドキュメント ライブラリをサポートしています。指定したパスにあるコンテンツはすべてフィルタされます。

          REST

          データストアの作成時にフィルタを追加するには、setUpDataConnector メソッドを呼び出します。

          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"
            ]
        }
        }'

          次のように置き換えます。

          • PROJECT_ID: 実際のプロジェクトの ID。
          • ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を指定します。
            • 米国のマルチリージョンの場合は us
            • EU のマルチリージョンの場合は eu
            • グローバル ロケーションの場合は global
            詳細については、データストアのマルチリージョンを指定するをご覧ください。
          • LOCATION: データストアのマルチリージョン（global、us、eu）
          • COLLECTION_ID: データストアの一意の ID。
          • COLLECTION_DISPLAY_NAME: データストアの表示名。
          • CLIENT_ID: Microsoft OneDrive 認証用のクライアント ID。
          • CLIENT_SECRET: Microsoft OneDrive 認証用のクライアント シークレット。
          • INSTANCE_URI: Microsoft OneDrive のインスタンス URI。
          • TENANT_ID: Microsoft OneDrive のテナント ID。
          • FILTER_TYPE: Microsoft OneDrive データストアに追加されるフィルタの種類。詳細については、フィルタの種類をご覧ください。
          • FILTER_KEY: フィルタのキー。データ内のフィールドに対応します。詳細については、フィルタキーをご覧ください。
          • FILTER_VALUES: 指定された FILTER_KEY でフィルタする値。

        フィルタの種類とフィルタの追加の詳細については、Microsoft OneDrive データストアにフィルタを追加するをご覧ください。

    6. [データの取り込み] を選択した場合は、[詳細オプション] セクションで次の操作を行います。

      1. 省略可: システムで静的 IP アドレスのセットを許可するには、[静的 IP アドレスを有効にする] チェックボックスをオンにします。詳細については、静的 IP 下り（外向き）を構成するをご覧ください。
      2. 省略可: [Max QPS] フィールドに最大秒間クエリ数を入力して、コネクタが Microsoft OneDrive インスタンスに送信するクエリにレート制限を適用します。
      3. 省略可: Microsoft Purview 情報保護で暗号化されたすべてのファイルの復号を試みるには、[Microsoft Purview 情報保護で暗号化されたファイルを復号する] チェックボックスをオンにします。

    7. [続行] をクリックします。

    8. [検索するエンティティ]（[連携検索] を選択した場合）または [同期するエンティティ]（[データの取り込み] を選択した場合）セクションで、次の操作を行います。

      1. 必要なエンティティをすべて選択します。
      2. [連携検索] を選択した場合は、次の手順に進みます。
      3. [データの取り込み] を選択した場合は、次の操作を行います。
        1. （省略可）特定のプロジェクトを同期するには、次の操作を行います。
          1. [フィルタ] をクリックします。
          2. フィルタでインデックスからエンティティを除外するには、[インデックスから除外する] チェックボックスをオンにします。インデックスにエンティティが含まれるようにするには、[インデックスに含める] チェックボックスをオンにします。
          3. キーを入力します。キーを入力するごとに Enter キーを押します。
          4. [保存] をクリックします。
        2. 同期スケジュールを構成するには、次の操作を行います。
          1. [同期頻度] リストで、同期の頻度を選択します。
            • エンティティ データと ID データの完全同期を個別にスケジュールするには、[完全同期] セクションのメニューを開き、[カスタマイズ オプション] を選択します。
          2. [増分同期の頻度] リストで、増分同期の頻度を選択します。詳細については、同期スケジュールをご覧ください。

  7. [続行] をクリックします。

  8. [アクション] セクションで次の操作を行います。

    1. [連携検索] を選択した場合:
      1. [Select Microsoft OneDrive actions to enable] で、カテゴリからアクションを選択して、そのコネクタを有効にします。

    2. [データの取り込み] を選択した場合:

      1. [認証の設定] セクションで、選択した接続モードに基づいて認証を構成します。 次の認証情報を入力します。

        • クライアント ID: 組織の Microsoft Entra ID に登録されているアプリケーションの固有識別子。
        • クライアント シークレット: Microsoft Entra ID での OAuth 2.0 アプリケーション登録プロセスで生成された秘密鍵。
        • テナント ID: Microsoft Entra 管理センターでの組織の固有識別子。

        詳細については、クライアント認証情報を取得するをご覧ください。

      2. [ログイン] をクリックして Microsoft OneDrive にログインし、アカウントを確認します。

      3. [続行] をクリックします。

      4. [詳細設定] セクションで、Entra アプリケーションの作成時に取得したテナント ID である Azure テナントを入力します。

      5. [宛先] セクションで、Microsoft OneDrive サイトのベース URL を入力します。

      6. [Select Microsoft OneDrive actions to enable] で、カテゴリからアクションを選択して、そのコネクタを有効にします。

  9. [続行] をクリックします。

    アクションのリストを表示および管理するには、アクションの表示と管理をご覧ください。

  10. [構成] セクションで、次の操作を行います。

    1. [マルチリージョン] リストから、データコネクタのロケーションを選択します。
    2. [データコネクタ名] フィールドに、コネクタの名前を入力します。
    3. ロケーションとして us または eu を選択した場合は、[暗号化設定] を構成します。
      • 省略可: 単一リージョンの鍵を構成していない場合は、[設定ページに移動] をクリックして構成します。詳細については、サードパーティ コネクタの単一リージョンの鍵を登録するをご覧ください。
      • [Googleが管理する暗号鍵] または [Cloud KMS 鍵] を選択します。
      • [Cloud KMS 鍵] を選択した場合:
        • [鍵管理のタイプ] リストで、適切なタイプを選択します。
        • [Cloud KMS 鍵] リストで、鍵を選択します。
      詳細については、顧客管理の暗号鍵をご覧ください。

  11. [続行] をクリックします。

  12. [お支払い] セクションで、[全般的な料金] または [構成可能な料金] を選択します。詳細については、プロジェクトの課金ステータスを確認するとライセンスをご覧ください。

  13. [作成] をクリックします。Gemini Enterprise によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

[データストア] ページで、データストア名をクリックしてステータスを確認します。データストアの状態が「作成中」から「アクティブ」に変わると、Microsoft OneDrive コネクタを使用できるようになります。

Microsoft OneDrive で作成された取り込みコネクタの場合、同期が開始されると、データストアの状態が「作成中」から「実行中」に変わります。取り込みが完了すると、「アクティブ」に変わり、データストアが完全に構成されたことを示します。データ量によっては、取り込みに数時間かかることがあります。

データストアを作成したら、アプリを作成し、それを Microsoft OneDrive データストアに接続します。クエリを実行する前に、Gemini Enterprise が Microsoft OneDrive にアクセスすることを承認します。

データの取り込みのリアルタイム同期を有効にする

データストアのリアルタイム同期を有効にする手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. ナビゲーション メニューで [データストア] をクリックします。

  3. リアルタイム同期を有効にする Microsoft OneDrive データストアの名前をクリックします。

  4. データストアの [データ] ページで、[コネクタの状態] が「アクティブ」に変わるまで待ちます。

  5. [リアルタイム同期] フィールドで、[表示 / 編集] をクリックします。

  6. リアルタイム同期を有効にするには、[リアルタイム同期を有効にする] 切り替えボタンをクリックします。

  7. [クライアント シークレット] フィールドに値を入力します。この値は、Microsoft OneDrive Webhook イベントの検証に使用されます。20 文字の文字列を使用することをおすすめします。

  8. [保存] をクリックします。

    [リアルタイム同期] フィールドが [実行中] に変わるまで待ちます。

データの取り扱いとクエリの実行

このセクションでは、Gemini Enterprise がクエリを管理する方法と、フェデレーション データストアの使用によるプライバシーへの潜在的な影響について説明します。

クエリ実行

Microsoft OneDrive を承認した後、Gemini Enterprise に検索クエリを送信すると、次のようになります。

  • Gemini Enterprise は、検索クエリを Microsoft API に直接送信します。
  • Gemini Enterprise は、結果を接続された他のデータソースからの結果と統合して、包括的な検索結果を表示します。

データの取り扱い

サードパーティの連携検索を使用する場合、次のデータ処理ルールが適用されます。

  • クエリ文字列がサードパーティの検索バックエンド（Microsoft API）に送信されます。
  • これらのサードパーティは、クエリをユーザーの ID に関連付ける場合があります。
  • 複数のフェデレーション検索データソースが有効になっている場合、クエリはそれらすべてに送信されることがあります。
  • データがサードパーティ システムに到達すると、そのシステムの利用規約とプライバシー ポリシーが適用されます。

次のステップ