列出特徵檢視畫面

您可以擷取 Google Cloud 專案中網路商店內建立的所有特徵檢視區塊執行個體清單。您也可以查看每個特徵檢視區塊的特徵資料來源，包括：

  • 一或多個特徵群組及其組成特徵。每個特徵群組都與特徵資料來源相關聯，例如 BigQuery 資料表或檢視區塊。每個特徵都會指定 BigQuery 資料來源中的資料欄。

  • 直接與特徵檢視區塊相關聯的 BigQuery 資料表或檢視區塊。

如果特徵檢視區塊設為使用專屬服務帳戶，該特徵檢視區塊的詳細資料也會包含相關聯的服務帳戶電子郵件地址。如要進一步瞭解如何使用專屬服務帳戶設定建立特徵檢視區塊，請參閱「設定特徵檢視區塊的服務帳戶」。

事前準備

向 Gemini Enterprise Agent Platform 驗證，除非您已完成驗證。

選取這個頁面上的分頁，瞭解您打算如何使用範例：

控制台

使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，無須設定驗證。

REST

如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

    安裝 Google Cloud CLI。

    若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

列出網路商店中的特徵檢視畫面

使用下列範例，在專案中為特定位置的網路商店，擷取建立的功能檢視表清單。

控制台

按照下列操作說明，使用 Google Cloud 控制台查看網路商店中的特徵檢視區塊清單。

  1. 在 Google Cloud 控制台的「Agent Platform」部分，前往「特徵儲存庫」頁面。

    前往「特徵儲存庫」頁面

  2. 按一下「網路商店」。

  3. 按一下網路商店名稱，即可在「網路商店詳細資料」頁面查看詳細資料。

  4. 在「功能檢視畫面」部分，您可以查看所選地點的所有網路商店清單。

REST

如要擷取專案中特定線上商店內建立的所有 FeatureView 執行個體清單，請使用 featureViews.list 方法傳送 GET 要求。

使用任何要求資料之前，請先修改下列項目的值：

  • LOCATION_ID：網路商店所在的區域，例如 us-central1。
  • PROJECT_ID：專案 ID。
  • FEATUREONLINESTORE_NAME：要查看特徵檢視區塊清單的網路商店名稱。

HTTP 方法和網址：

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews

如要傳送要求，請選擇以下其中一個選項：

curl

執行下列指令： 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews"

PowerShell

執行下列指令： 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews" | Select-Object -Expand Content
您應該會收到類似如下的 JSON 回應：如果回應中列出的任何功能檢視畫面有專屬的服務帳戶設定，詳細資料中也會列出服務帳戶電子郵件地址。在本範例中，SERVICE_ACCOUNT_EMAIL 是與特徵檢視畫面 FEATUREVIEW_NAME_1 相關聯的服務帳戶電子郵件地址。 
{
  "featureViews": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_1",
      "createTime": "2023-09-06T23:46:49.936284Z",
      "updateTime": "2023-09-06T23:46:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_1",
              "FEATURE_ID_2",
            ]
          }
        ]
      }
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_2",
      "createTime": "2024-02-05T23:48:49.936284Z",
      "updateTime": "2024-02-05T23:48:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_3",
              "FEATURE_ID_4",
            ]
          }
        ]
      }
    }
  ]
}

後續步驟