データストアとエンティティの詳細を取得する

このページでは、 Google Cloud コンソールまたは Discovery Engine REST API を使用して、Gemini Enterprise データストアとその基盤となるエンティティのリソースの詳細を取得する方法について説明します。

API を使用してデータストアを操作する場合（リソースレベルの IAM アクセス制御の構成、検索エンドポイントのクエリ、取り込みパイプラインの自動化など）、ターゲット データストアとその基盤となるエンティティの一意のリソース ID が必要になります。

データストアのコンセプト

Discovery Engine API でデータストア リソースがどのように構造化されているかを理解するには、次のコンセプトを考慮してください。

コンセプト 説明
データストア Google またはサードパーティのデータソースから取り込まれたデータのコンテナ。スタンドアロン データストアはデフォルト コレクション（default_collection）に属します。詳細については、Gemini Enterprise のコンセプトとアプリとデータストアについてをご覧ください。
データの収集 Google Cloud プロジェクトとロケーション（projects/{project}/locations/{location}/collections/{collection}）内の論理グループ リソース。

マルチエンティティのサードパーティ データストア（Jira、Salesforce、SharePoint Online など）は、データストア インスタンスを表す専用のコレクションを作成します。
データストア エンティティ 複数のエンティティ タイプ（Jira の課題、Jira のプロジェクト、SharePoint ファイルなど）を含むサードパーティのデータソースを接続すると、Gemini Enterprise はエンティティ タイプごとに個別の子データストアを自動的に作成します。

これらのエンティティ データストアは、collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID} の子リソースとして存在します。

詳細については、サードパーティ データストア用の構造化データとコネクタとデータストアの概要をご覧ください。

データストアとエンティティの詳細を取得する

次のオプションのいずれかを選択します。

コンソール

Google Cloud コンソールでデータストアとエンティティの詳細を取得する手順は次のとおりです。

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

    [データストア] ページに移動

  2. ターゲット データストアの名前をクリックします。

  3. データストアの詳細ページで、ヘッダーに表示されているデータストア ID を確認します。

  4. データストアにエンティティが含まれている場合は、[エンティティ] タブをクリックして、構成されたエンティティ、表示名、対応するエンティティ データストア ID（DataConnector3_entityA や DataConnector3_entityB など）のリストを表示します。

REST

REST API を使用してデータストアとエンティティの ID を取得するには、次の操作を行います。

  1. データストア コレクション ID を一覧表示します（マルチエンティティ データストアの場合）。

    複数のエンティティを含むサードパーティ データストア（Jira や Salesforce など）の場合、Gemini Enterprise はコネクタ インスタンスを表す専用のコレクションを作成します。collections リスト エンドポイントを呼び出して、プロジェクト内のコレクション ID を取得します。

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"

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

    • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
    • ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を指定します。
      • 米国のマルチリージョンの場合は us
      • EU のマルチリージョンの場合は eu
      • グローバル ロケーションの場合は global
      詳細については、データストアのマルチリージョンを指定するをご覧ください。
    • LOCATION: データストアのマルチリージョン（global、us、eu）。

    レスポンスには、コレクションのリストが含まれます。

    {
  "collections": [
    {
      "name": "projects/123456789/locations/global/collections/DataConnector3",
      "displayName": "Jira Production Data Store"
    }
  ]
}

    この例では、コレクション ID は DataConnector3 です。この ID は、コネクタ インスタンスのコレクション レベルのアクセス制御を構成するときに使用します。

  2. default_collection の下にエンティティとスタンドアロンのデータストア ID を一覧表示します。

    Gemini Enterprise では、スタンドアロン データストアやマルチエンティティ コネクタの子エンティティなど、すべてのデータストア リソースが default_collection の下に存在します。マルチエンティティ データストアには専用のコレクション ID（DataConnector3 など）がありますが、子エンティティ データストアは default_collection に登録され、コネクタ ID が接頭辞として付加されます。

    default_collection で dataStores リスト エンドポイントを呼び出して、データストアとエンティティ ID を特定します。

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores"

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

    • PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。
    • ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を指定します。
      • 米国のマルチリージョンの場合は us
      • EU のマルチリージョンの場合は eu
      • グローバル ロケーションの場合は global
      詳細については、データストアのマルチリージョンを指定するをご覧ください。
    • LOCATION: データストアのマルチリージョン（global、us、eu）。

    レスポンスには、データストアのリストが含まれます。

    {
  "dataStores": [
    {
      "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityA",
      "displayName": "Jira Issues Entity"
    },
    {
      "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityB",
      "displayName": "Jira Projects Entity"
    }
  ]
}

    この例では、エンティティ データストアの ID は DataConnector3_entityA と DataConnector3_entityB です。これらの ID は、REST API を使用してマルチエンティティ データストアの基盤となるすべてのエンティティ データストアのアクセス制御を構成するときに使用します。

次のステップ