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

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

始める前に

データストアを作成する前に Google ドライブ環境を準備するには、次の操作を行います。

  • 接続する Google ドライブ インスタンスで使用するアカウントと同じアカウントで Google Cloud コンソールにログインする必要があります。Gemini Enterprise は、Google Workspace お客様 ID を使用して Google ドライブに接続します。個人の Google アカウント(末尾が @gmail.com の一般ユーザー向けアカウント)にはお客様 ID がなく、サポートされていません。

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

  • すべてのドキュメントにアクセスできることを確認します。このドメインが所有する共有ドライブにドキュメントを配置するか、所有権をこのドメインのユーザーに割り当てます。

  • Google Workspace で Gemini Enterprise へのアクセスを有効にする:Google 管理コンソールで、ユーザーと Google ドライブのデータ所在地が存在する組織の Google Workspace 管理者が、Gemini Enterprise に Google Workspace データへのアクセスを許可するを有効にする必要があります。この設定がオフの場合、Google ドライブの検索結果は Gemini Enterprise ウェブアプリに返されません(API で 403 Permission Denied: Workspace access for Agentspace disabled by organization admin. エラーが返されることがあります)。手順については、Gemini Enterprise による Google Workspace データへのアクセスを制御するをご覧ください。

  • スマート機能を有効にする: Google Workspace アカウントで、[Google Workspace のスマート機能] と [他のGoogle サービスのスマート機能] の両方をオンにします。詳しくは、Google Workspace のスマート機能をオンまたはオフにするをご覧ください。

  • OAuth アプリを許可リストに追加する: Google ドライブ データストアは、 Googleが管理する OAuth アプリを使用してデータにアクセスします。組織で OAuth アプリへのアクセスが制限されている場合は、Google Workspace 管理者がこのアプリを組織の許可リストに追加する必要があります。詳細については、 Google管理の OAuth アプリを許可リストに登録するをご覧ください。

  • 組織間のアクセスを構成する(該当する場合): デフォルトでは、Gemini Enterprise は、ユーザーの Google Workspace お客様 ID が Google ドライブ データストアと Google Cloud プロジェクトの組織と一致する場合にのみ、ユーザーが Google ドライブ データストアを検索できるようにします。ユーザーまたは Google ドライブのデータが別の Google Workspace 組織に属している場合(たとえば、 Google Cloud プロジェクトが 1 つのドメインにあり、ユーザーが 1 つ以上の別の Google Workspace ドメインまたはテストテナントからログインする場合)は、次の手順を完了します。

    1. Cloud カスタマーケアに連絡して、各ユーザーの Google Workspace 組織のお客様 ID(C01234567 など)を Google Cloud プロジェクトの許可リストに追加します。
    2. 各 Google Workspace 組織の Google Workspace 管理者に、その組織の Google 管理コンソールで [Gemini Enterprise に Google Workspace データへのアクセスを許可する] を有効にしてもらいます。この設定を Google Cloud プロジェクトの組織でのみ有効にしても不十分です。詳しくは、Gemini Enterprise による Google Workspace データへのアクセスを制御するをご覧ください。

    また、ユーザーが自分の組織外で所有されているドキュメントを検索する必要がある場合は、アプリで [クロスドメインのドキュメントを含める] を有効にします。このオプションは、アプリを作成するときに選択するか、後で [ウェブアプリの機能を管理する] で有効にできます。

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

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

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

    Gemini Enterprise

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

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

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

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

  6. 省略可: [データ] セクションで、データストアが検索する Google ドライブのコンテンツをスコープするフィルタを構成します。 Google Cloud コンソールまたは REST API を使用してフィルタを構成するには、次のいずれかのオプションを選択します。

    コンソール

    1. [共有ドライブ ID] フィールド、[フォルダ ID] フィールド、またはその両方に、フィルタする ID を入力します。
    2. 各フィールドで、[含める] を選択して指定した ID のみを検索するか、[除外] を選択して検索から除外します。各フィールドに追加モードまたは除外モードのいずれかを構成します。両方を構成することはできません。
    3. フォルダ ID または共有ドライブ ID を確認するには、Google ドライブでフォルダまたは共有ドライブを開き、URL から ID をコピーします。URL の形式は https://drive.google.com/drive/folders/ID です。例: https://drive.google.com/drive/folders/123456789012345678901。

    REST API

    フィルタを使用してデータストアを作成するには、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": {
               "FILTER_TYPE": {
                 "FILTER_KEY": [
                   "FILTER_VALUE_1",
                   "FILTER_VALUE_2"
                 ]
               }
             },
             "entities": [
               {
                 "entityName": "google_drive"
               }
             ],
             "connectorModes": [
               "FEDERATED"
             ]
           }
       }'
       

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

    • PROJECT_ID: 実際のプロジェクトの ID。
    • ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を指定します。
      • 米国のマルチリージョンの場合は us
      • EU のマルチリージョンの場合は eu
      • グローバル ロケーションの場合は global
      詳細については、データストアのマルチリージョンを指定するをご覧ください。
    • LOCATION: データストアのマルチリージョン(global または us)。
    • COLLECTION_ID: データストアの一意の ID。
    • COLLECTION_DISPLAY_NAME: データストアの表示名。
    • FILTER_TYPE: フィルタのタイプ。包含の場合は admin_filter、除外の場合は admin_exclusion_filter。admin_filter または admin_exclusion_filter のリストに値を入力します。両方に入力することはできません。
    • FILTER_KEY: フィルタするドライブ エンティティ(SharedDriveIds または FolderIds)。
    • FILTER_VALUE_1、FILTER_VALUE_2: フィルタする共有ドライブ ID またはフォルダ ID。
  7. [アクション] セクションで、リストからアクションを選択して、Google ドライブ コネクタに対して有効にします。

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

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

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

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

  10. 省略可: [タグ] フィールドに、データストアの安定した識別子を入力します。この ID は、コネクタの異なるバージョンで使用され、データストアの作成後に変更できなくなります。そのため、後で変更する必要のない値を選択してください。

  11. 省略可: [Sensitive Data Protection ポリシー] セクションで、既存の Sensitive Data Protection コンテンツ ポリシーをアタッチして、Gemini Enterprise がこのデータストアを介して取得する機密データを検査してブロックします。詳細については、ソース内の機密データを保護するをご覧ください。組織で Sensitive Data Protection コンテンツ ポリシーが必要ない場合は、この手順をスキップできます。

  12. [作成] をクリックします。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 のお客様 ID が Google Workspace データストアの組織と Google Cloud プロジェクトに一致するユーザーのみに許可されます。ただし、ユーザーの Google Workspace のお客様 ID がプロジェクトの許可リストに登録されている場合は除きます。 不一致が意図しないものである場合は、Google Workspace ユーザーと同じ組織に属する Google Cloud プロジェクトでデータストアを再作成するか、アプリから Google Workspace データストアを削除します。ユーザーと Google Workspace データストアが異なる組織に属している場合は、Cloud カスタマーケアに連絡して、各ユーザーの Google Workspace お客様 ID を Google Cloud プロジェクトの許可リストに追加します。各ユーザーの組織の Google Workspace 管理者が Gemini Enterprise による Google Workspace データへのアクセスを有効にしていることを確認します。また、ユーザーが自分の組織外で所有されているドキュメントを検索する必要がある場合は、[ウェブアプリの機能を管理する] で [クロスドメインのドキュメントを含める] を有効にします。
403 Permission Denied Agentspace による Workspace へのアクセスが、組織管理者によって無効にされています。 ユーザーの Google Workspace 組織の Google Workspace 管理者が、Gemini Enterprise の Google Workspace データへのアクセスを無効にしています。Gemini Enterprise ウェブアプリでは、このエラーが直接表示されないことがあります。代わりに、クエリで一致する Google ドライブ ファイルが返されません。 ユーザーの Google Workspace 組織の Google Workspace 管理者に連絡して、アクセスを有効にするよう依頼します。組織間の設定では、ユーザーが Google ドライブにクエリを実行する各 Google Workspace 組織の Google 管理コンソールで、この設定を有効にする必要があります。
400 無効な引数 リクエストに無効な引数が含まれています。 このエラーは、リクエスト内のデータコネクタ名が命名要件を満たしていない場合に発生します。データコネクタの名前が 1 ~ 63 文字で、先頭が英小文字、末尾が英小文字または数字で、英小文字、数字、ハイフン、アンダースコアのみが含まれていることを確認します。たとえば、123456789-cymbal-collection ではなく cymbal-collection-123456789 のような名前を使用します。

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

次のステップ