Google ドライブのデータストアを設定する

このページでは、データストアを作成して Google ドライブを Gemini Enterprise に接続する方法について説明します。この接続により、Gemini Enterprise は Google ドライブから情報を直接取得できます。データは Gemini Enterprise インデックスにコピーされないため、データ ストレージを管理する必要はありません。

始める前に

  • 接続する Google ドライブ インスタンスで使用するのと同じアカウントで Google Cloud コンソールにログインする必要があります。Gemini Enterprise は、Google Workspace お客様 ID を使用して Google ドライブに接続します。

  • Gemini Enterprise でデータソースのアクセス制御を適用してデータを保護するには、ID プロバイダが構成されていることを確認してください。

  • すべてのドキュメントにアクセスできることを確認します。そのためには、ドキュメントをドメイン所有の共有ドライブに配置するか、ドメイン内のユーザーをそのドキュメントのオーナーに設定する必要があります。

  • Google ドライブのデータを Gemini Enterprise に接続するには、他の Google サービスの Google Workspace スマート機能を有効にします。詳しくは、Google Workspace のスマート機能をオンまたはオフにするをご覧ください。

Google ドライブのデータストアを作成する

Google ドライブのデータストアを作成する手順は次のとおりです。

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

    Gemini Enterprise

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

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

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

  5. [ソース] セクションで「Google ドライブ」を検索し、[選択] をクリックします。

  6. [データ] セクションで、データストアのドライブソースを指定します。 Google Cloud コンソールまたは API を使用して、どの Google ドライブ コンテンツをインデックスに登録するかをスコープするフィルタを構成できます。

    コンソール

    1. データストアのドライブソースを選択します。
      • すべて: ワークスペース内のすべてのドライブをデータストアに追加します。
      • フォルダ フィルタ: 検索対象を特定のフォルダに限定します。[含む] を選択すると、検索範囲が一覧表示されたフォルダのみに限定されます。[除外] を選択すると、一覧表示されたフォルダが検索から除外されます。次に、1 つ以上のフォルダ ID を追加します。
      • 共有ドライブ フィルタ: 検索対象を特定の共有ドライブに限定します。[含める] を選択すると、検索対象がリストに表示された共有ドライブのみに絞り込まれます。[除外する] を選択すると、リストに表示された共有ドライブが検索対象から除外されます。次に、1 つ以上の共有ドライブ ID を追加します。
    2. フィルタの種類ごとに、[含む] モードまたは [除外] モードのいずれか 1 つを構成します。両方を構成することはできません。
    3. フォルダ ID または共有ドライブ ID を確認するには、Google ドライブでフォルダまたは共有ドライブに移動して、URL から ID をコピーします。URL の形式は https://drive.google.com/corp/drive/folders/ID です。例: https://drive.google.com/corp/drive/folders/123456789012345678901

    REST

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

    包含リストは admin_filter で設定し、除外リストは admin_exclusion_filter で設定します。フィルタの種類ごとに、admin_filter または admin_exclusion_filter のいずれかのリストにデータを入力します。両方にデータを入力することはできません。

    
   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":{
             "admin_filter":{
               "SharedDriveIds": INCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": INCLUDED_FOLDER_IDS
             },
             "admin_exclusion_filter":{
               "SharedDriveIds": EXCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": EXCLUDED_FOLDER_IDS
             }
           },
           "entities":[
             {
               "entityName":"drive"
             }],
           "connectorModes":[
             "FEDERATED"
             ]
         }
       }'

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

    • PROJECT_ID: プロジェクト ID。
    • ENDPOINT_LOCATION: アプリケーションのリージョン。たとえば、us や eu です。
    • LOCATION: データストアのマルチリージョン（global または us）。
    • COLLECTION_ID: データストアの一意の ID。
    • COLLECTION_DISPLAY_NAME: データストアの表示名。
    • INCLUDED_SHARED_DRIVE_IDS: 検索に含める共有ドライブ ID のリスト（例: ["0ABCdEfGhIjKlMnOpQ"]）。共有ドライブの包含リストを設定しない場合は、空のリスト [] を使用します。
    • INCLUDED_FOLDER_IDS: 検索に含めるフォルダ ID のリスト（例: ["1AbCdEfGhIjKlMnOpQrStUvWxYz"]）。フォルダの包含リストを設定しない場合は、空のリスト [] を使用します。
    • EXCLUDED_SHARED_DRIVE_IDS: 検索から除外する共有ドライブ ID のリスト。共有ドライブの除外リストを設定しない場合は、空のリスト [] を使用します。
    • EXCLUDED_FOLDER_IDS: 検索から除外するフォルダ ID のリスト。フォルダの除外リストを設定しない場合は、空のリスト [] を使用します。

    フィルタの種類とフィルタの追加について詳しくは、Google ドライブのデータストアにフィルタを追加するをご覧ください。

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

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

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

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

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

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

データストアの状態を確認する手順は次のとおりです。

  1. データストア リストでコネクタに移動し、状態が「アクティブ」に変わるまでモニタリングします。
  2. データストアの状態が「作成中」から「アクティブ」に変わると、Google ドライブ コネクタを使用できるようになります。

データストアを作成したら、クエリを実行する前にアプリを作成し、Google ドライブ データストアに接続します。

クエリ実行

Google ドライブを認可した後、検索クエリを入力すると、次のようになります。

  1. Gemini Enterprise は、検索クエリを Google Drive API に送信します。

  2. Gemini Enterprise は、結果を他のソースからの結果と統合して表示します。

エラー メッセージとトラブルシューティング

次の表に、この Google データソースを扱う際に表示される可能性のあるエラー メッセージを、HTTP エラーコードや推奨のトラブルシューティング手順とともに示します。

エラーコード エラー メッセージ 説明 トラブルシューティング
403 Permission Denied サービス アカウントの認証情報を使用した検索は、Google Workspace のデータストアではサポートされていません。 検索対象のエンジンに Google Workspace データストアがあり、渡された認証情報はサービス アカウントのものです。Google Workspace データストアでサービス アカウントの認証情報を使用して検索することはできません。 ユーザー認証情報を使用して検索を呼び出すか、Google Workspace データストアをエンジンから削除します。
403 Permission Denied Google Workspace データストアでは一般ユーザー向けアカウントはサポートされていません。 検索は一般ユーザー向けアカウント（@gmail.com）の認証情報を使用して呼び出されますが、これは Google Workspace データストアではサポートされていません。 エンジンから Google Workspace データストアを削除するか、管理対象の Google アカウントを使用します。
403 Permission Denied データストアのユーザー ID が一致しません 検索は、Google Workspace データストアと同じ組織に属するユーザーのみに許可されています。 ユーザーと Google Workspace データストアが異なる組織に属している場合は、Google Workspace データストアをエンジンから削除するか、サポートにお問い合わせください。
403 Permission Denied Agentspace による Workspace へのアクセスが、組織の管理者によって無効にされています。 Google Workspace 管理者が Gemini Enterprise の Google Workspace データへのアクセスを無効にしています。 アクセスを有効にするには、Google Workspace 管理者にお問い合わせください。
400 無効な引数 リクエストに無効な引数が含まれています。 このエラーは、リクエストのデータコネクタ名が命名要件を満たしていない場合に発生します。データ コネクタの名前を確認します。1 ～ 63 文字で、先頭は英小文字、末尾は英小文字または数字で、英小文字、数字、ハイフン、アンダースコアのみが含まれていることを確認します。たとえば、123456789-cymbal-collection ではなく cymbal-collection-123456789 のような名前を使用します。

Google ドライブデータをクエリする際に発生する一般的な検索の問題については、一般的な検索の問題をご覧ください。

次のステップ