Kelola informasi katalog

Halaman ini menjelaskan cara mengelola informasi produk Anda setelah mengimpor katalog ke Vertex AI Search untuk retail. Anda dapat membaca, menulis, dan menghapus produk di katalog Anda.

Agar katalog Anda tetap terbaru seiring perubahan informasi produk, impor katalog Anda dengan cara yang sama seperti saat pertama kali mengimpornya. Untuk mendapatkan bantuan dalam mengimpor katalog, lihat Mengimpor informasi katalog.

Membuat/Mendapatkan/Memperbarui/Menghapus tutorial produk

Tutorial ini menunjukkan cara menggunakan metode API yang melakukan tindakan berikut:

  • Membuat produk
  • Dapatkan produk
  • Perbarui produk
  • Hapus produk

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

Buat tutorial produk

Tutorial ini menunjukkan kepada Anda cara membuat satu produk.

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

Dapatkan tutorial produk

Tutorial ini menunjukkan kepada Anda cara mengambil item produk.

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

Perbarui tutorial produk

Tutorial ini menunjukkan cara memperbarui produk di katalog.

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

Hapus tutorial produk

Tutorial ini menunjukkan cara menghapus produk dari katalog.

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

Upload produk

curl

Buat satu item produk menggunakan metode REST products.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
      "title": "PRODUCT_TITLE",
      "categories": "CATEGORY"
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products?productId=PRODUCT_ID"

Jika permintaan berhasil, objek produk akan ditampilkan, seperti dalam contoh berikut.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": [
    "CATEGORY"
  ],
  "title": "PRODUCT_TITLE",
  "availability": "IN_STOCK"
}

Java

public static Product createProduct(Product productToCreate, String productId)
    throws IOException {
  return getProductServiceClient().createProduct(
      DEFAULT_BRANCH_NAME, productToCreate, productId
  );
}

Perbarui informasi produk

Saat katalog produk berubah, Anda dapat memperbarui katalog dengan mengupload perubahan produk seperti produk baru, harga, dan status stok secara real time. Anda hanya dapat mengupload produk yang telah ditambahkan atau diubah; Anda tidak perlu memuat ulang seluruh katalog.

curl

Perbarui informasi produk menggunakan metode products.patch.

Contoh berikut memperbarui judul untuk produk tertentu:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
       "title": "new-title-value"
    }" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID?updateMask=title"

Jika permintaan berhasil, objek produk akan ditampilkan, seperti dalam contoh berikut.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": [
    "Parent category > Child category"
  ],
  "title": "new product title",
  "availability": "IN_STOCK"
}

Java

public static Product updateProduct(Product productToUpdate) throws IOException {
  return getProductServiceClient().updateProduct(productToUpdate, FieldMask.getDefaultInstance());
}

Menghapus informasi produk

Meskipun API menyediakan cara untuk menghapus produk dari katalog Anda, perlu diingat bahwa jika Anda mencatat peristiwa pengguna yang terkait dengan item produk yang telah dihapus, API tersebut tidak dapat memproses peristiwa pengguna dengan benar dan peristiwa tersebut mungkin akan dihapus. Selain itu, menyertakan data katalog historis akan meningkatkan kualitas model Anda serta sangat penting untuk mendapatkan rekomendasi dan hasil penelusuran yang baik.

Anda harus menetapkan availability produk yang sudah tidak digunakan lagi ke OUT_OF_STOCK, bukan menghapusnya.

curl

Hapus produk menggunakan metode delete, yang mengganti PRODUCT_ID dengan ID produk yang ingin dihapus.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

Java

public static void deleteProduct(String productName) throws IOException {
  getProductServiceClient().deleteProduct(productName);
}

Mengambil item produk

curl

Anda mengambil item produk dengan membuat permintaan GET ke endpoint products, mengganti PRODUCT_ID dengan ID produk yang ingin Anda ambil:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"  \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

Anda akan melihat output yang mirip dengan berikut ini:

{
    "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
    "id": "PRODUCT_ID",
    "primaryProductId": "PRODUCT_ID",
    "type": "PRIMARY",
    "categories": [
      "Parent category > Child category"
    ],
    "title": "product title",
    "availability": "IN_STOCK"
}

Java

public static Product getProduct(String productName) throws IOException {
  return getProductServiceClient().getProduct(productName);
}

Melihat informasi gabungan tentang katalog Anda

Anda dapat melihat informasi gabungan tentang katalog dan melihat pratinjau produk yang diupload di tab Katalog pada halaman Data pada konsol Penelusuran Retail.

Evaluasi kualitas data katalog

Untuk menilai kualitas data katalog Anda:

  1. Buka halaman Kualitas data di Search for Retail console.

    Buka halaman Kualitas Data

    Halaman Kualitas data menilai apakah Anda perlu memperbarui data katalog untuk meningkatkan kualitas hasil penelusuran dan membuka tingkat performa penelusuran.

Untuk mengetahui informasi selengkapnya tentang cara memeriksa kualitas data penelusuran dan melihat tingkat performa penelusuran, lihat Membuka tingkat performa penelusuran.

Untuk ringkasan metrik katalog yang tersedia, lihat Metrik kualitas katalog.

Ubah tipe produk

Saat mengimpor produk, Anda dapat menentukan apakah jenis produk adalah utama, varian, atau koleksi. Jika jenis produk berubah atau tidak ditentukan dengan benar, Anda harus menghapus produk dan membuatnya dengan jenis terbaru yang ditentukan.

Jenis produk dapat ditetapkan ke TYPE_UNSPECIFIED, PRIMARY, VARIANT, atau COLLECTION. Untuk mengetahui detail selengkapnya, lihat product.Type dalam dokumentasi referensi.

Ubah konfigurasi tingkat produk

Saat mengimpor katalog dengan Merchant Center, Anda harus menentukan apakah produk merupakan produk primer atau varian. Jika tingkat produk ini berubah atau tidak ditentukan dengan benar, gunakan prosedur di bawah untuk memperbaiki konfigurasinya. Anda harus memiliki peran IAM Admin Retail untuk menyelesaikan prosedur ini.

  1. Pastikan tidak ada impor yang terjadi saat Anda mengonfigurasi ulang tingkat produk. Hal ini memastikan data tidak diupload pada tingkat yang salah.

  2. Hapus semua item produk. Lihat products.delete. Katalog harus benar-benar kosong sebelum melanjutkan ke langkah berikutnya.

  3. Impor ulang data Anda untuk mengubah konfigurasi tingkat produk.

    Prosedur ini bergantung pada cara Anda mengimpor. Ikuti prosedur yang sesuai di Mengimpor Informasi Katalog untuk menetapkan level produk ke konfigurasi barunya.

  4. Selesaikan impor katalog baru dengan konfigurasi level yang dimodifikasi, menggunakan prosedur yang Anda pilih di Mengimpor Informasi Katalog.

  5. Sesuaikan semua model yang ada.

    Untuk men-tuning model, buka halaman Model, klik nama model untuk melihat halaman detailnya, lalu klik Penyesuaian Manual di panel tombol.

    Buka halaman Model

    Untuk mengetahui detail biaya penyesuaian, lihat Harga.