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

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

始める前に

Microsoft SharePoint の連携接続を設定する前に、次のことを確認してください。

  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

    • インスタンス URI

  3. Microsoft SharePoint 管理者の同意を得て、Microsoft API 権限を構成します。

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

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

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

    Gemini Enterprise

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

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

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

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

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

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

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

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

      1. 必要に応じて、次の認証情報を入力します。
        • クライアント ID: 組織の Microsoft Entra ID に登録されているアプリケーションの固有識別子。
        • クライアント シークレット: Microsoft Entra ID での OAuth 2.0 アプリケーション登録プロセスで生成された秘密鍵。
        • テナント ID: Microsoft Entra 管理センターでの組織の固有識別子。
        • インスタンス URI: Microsoft SharePoint インスタンスのベース URL（例: https://{your-domain}.sharepoint.com）。
        • Microsoft SharePoint 環境タイプ: Microsoft 365 テナントをホストする環境を選択します。
          • 標準の商用 Microsoft 365 または Government Community Cloud（GCC）に接続する場合は、[標準]（デフォルト）を選択します。
          • Microsoft 365 US Government ソブリン クラウド（GCC High または DoD）に接続する場合は、[米国政府] を選択します。

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

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

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

      • [連携検索] を選択した場合は、[ログイン] をクリックして、サードパーティのログインを完了します。

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

    5. [連携検索] を選択すると、[宛先] セクションが表示されます。サイトのベース URL を入力します。

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

    7. [**詳細オプション**] セクションで、[**Microsoft 365 クラウド環境**] を選択します。

      • Microsoft 365 US Government インスタンスに接続する場合は、一致するオプション（[GCC]、[GCC High]、または [DoD]）を選択します。
      • それ以外の場合は、デフォルトの [グローバル] のままにします。

    8. [連携検索] を選択した場合は、[詳細オプション] セクションで、含めるまたは除外する Microsoft SharePoint サイトまたは特定のパスを指定して、検索とアクションの範囲を絞り込むことができます。変更または取得できるのは、含まれているパス内のデータのみです。範囲外のデータのリクエストは失敗するか、結果が返されません。

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

      Console

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

      1. [サイトフィルタ] セクションで次の操作を行います。
        • フィルタタイプとして [検索に含める] または [検索から除外する] を選択します。
        • [サイト URL フィルタ] フィールドに、フィルタする正確な Microsoft SharePoint サイトの URL を https://{your-tenant}.sharepoint.com/sites/{your-site-name} の形式で入力します。

          注: サイトの URL を正確に入力します。この特定のフィールドでは、サブパス、フォルダ、ドキュメント ライブラリはサポートされていません。

      2. [パスフィルタ] セクションで次の操作を行います。
        • フィルタタイプとして [検索に含める] または [検索から除外する] を選択します。
        • [パスフィルタ] フィールドに、SharePoint のフルパスを入力します。

          注: このフィールドでは、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: SharePoint 認証用のクライアント ID。
      • CLIENT_SECRET: SharePoint 認証用のクライアント シークレット。
      • INSTANCE_URI: SharePoint のインスタンス URI。
      • TENANT_ID: SharePoint のテナント ID。
      • FILTER_TYPE: Microsoft SharePoint データストアに追加されるフィルタの種類。詳細については、フィルタタイプをご覧ください。
      • FILTER_KEY: フィルタの鍵。データ内のフィールドに対応します。詳細については、フィルタキーをご覧ください。
      • FILTER_VALUES: 指定した FILTER_KEY でフィルタする値。

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

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

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

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

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

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

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

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

        1. 必要に応じて、次の認証情報を入力します。

          • クライアント ID: 組織の Microsoft Entra ID に登録されているアプリケーションの固有識別子。
          • クライアント シークレット: Microsoft Entra ID での OAuth 2.0 アプリケーション登録プロセスで生成された秘密鍵。
          • テナント ID: Microsoft Entra 管理センターでの組織の固有識別子。
          • インスタンス URI: Microsoft SharePoint インスタンスのベース URL（例: https://{your-domain}.sharepoint.com）。

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

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

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

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

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

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

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

  11. データストアの作成フローに [詳細オプション] セクションが表示される場合は、そのセクションで [静的 IP アドレスを有効にする] チェックボックスをオンにできます。これにより、データストアは送信トラフィックに固定 IP アドレスのセットを使用するため、ソースシステムでの許可リストに適しています。詳細については、静的 IP エグレスを構成するをご覧ください。

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

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

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

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

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

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

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

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

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

リアルタイム同期では、ドキュメント エンティティのみが同期され、ID エンティティに関連するデータは同期されません。次の表に、リアルタイム同期でサポートされているドキュメント イベントを示します。

Microsoft SharePoint エンティティ 作成 更新 削除 権限の変更
添付ファイル
コメント
イベント
ファイル
ページ

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

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

    Gemini Enterprise

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

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

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

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

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

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

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

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

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

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

クエリ実行

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

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

データの取り扱い

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

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

次のステップ