Melihat daftar tampilan fitur

Anda dapat mengambil daftar semua instance tampilan fitur yang dibuat dalam toko online di project Google Cloud Anda. Untuk setiap tampilan fitur, Anda juga dapat melihat sumber data fitur tersebut, yang dapat berupa salah satu dari berikut ini:

  • Satu atau beberapa grup fitur dan fitur konstituennya. Setiap grup fitur dikaitkan dengan sebuah sumber data fitur, seperti tabel atau tampilan BigQuery. Setiap fitur menentukan sebuah kolom di sumber data BigQuery.

  • Tabel atau tampilan BigQuery yang terkait langsung dengan tampilan fitur.

Jika tampilan fitur dikonfigurasi untuk menggunakan akun layanan khusus, detail untuk tampilan fitur tersebut juga mencakup alamat email akun layanan terkait. Untuk mengetahui informasi selengkapnya tentang cara membuat tampilan fitur dengan konfigurasi akun layanan khusus, lihat Mengonfigurasi akun layanan untuk tampilan fitur.

Sebelum memulai

Lakukan autentikasi ke Gemini Enterprise Agent Platform, kecuali jika Anda sudah melakukannya.

Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

Konsol

Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

REST

Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    Instal Google Cloud CLI.

    Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Mencantumkan tampilan fitur di toko online

Gunakan contoh berikut untuk mengambil daftar tampilan fitur yang dibuat untuk sebuah toko online pada project Anda untuk suatu lokasi tertentu.

Konsol

Gunakan petunjuk berikut untuk melihat daftar tampilan fitur di toko online menggunakan konsol Google Cloud .

  1. Di bagian Agent Platform pada konsol Google Cloud , buka halaman Feature Store.

    Buka halaman Feature Store

  2. Klik Toko online.

  3. Klik nama toko online untuk melihat detailnya di halaman Detail toko online.

  4. Di bagian Tampilan fitur, Anda dapat melihat daftar semua toko online untuk lokasi yang dipilih.

REST

Untuk mengambil daftar semua instance FeatureView yang dibuat di penyimpanan online tertentu pada project Anda, kirim permintaan GET menggunakan metode featureViews.list

Sebelum menggunakan data permintaan mana pun, lakukan penggantian berikut:

  • LOCATION_ID: Region tempat toko online berada, seperti us-central1.
  • PROJECT_ID: Project ID Anda.
  • FEATUREONLINESTORE_NAME: Nama penyimpanan online tempat Anda ingin melihat daftar tampilan fitur.

Metode HTTP dan URL: 

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

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

Jalankan perintah berikut: 

$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
Anda akan menerima respons JSON yang mirip dengan berikut ini. Jika salah satu tampilan fitur yang tercantum dalam respons memiliki konfigurasi akun layanan khusus, alamat email akun layanan tersebut juga tercantum dalam detailnya. Dalam contoh ini, SERVICE_ACCOUNT_EMAIL adalah alamat email akun layanan yang terkait dengan tampilan fitur 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",
            ]
          }
        ]
      }
    }
  ]
}

Langkah berikutnya