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:
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:
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:
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:
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:
Upload produk
curl
Buat satu item produk menggunakan metode RESTproducts.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
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 metodeproducts.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
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
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
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:
Buka halaman Kualitas data di Search for Retail console.
Buka halaman Kualitas DataHalaman 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.
Pastikan tidak ada impor yang terjadi saat Anda mengonfigurasi ulang tingkat produk. Hal ini memastikan data tidak diupload pada tingkat yang salah.
Hapus semua item produk. Lihat
products.delete
. Katalog harus benar-benar kosong sebelum melanjutkan ke langkah berikutnya.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.
Selesaikan impor katalog baru dengan konfigurasi level yang dimodifikasi, menggunakan prosedur yang Anda pilih di Mengimpor Informasi Katalog.
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.
Untuk mengetahui detail biaya penyesuaian, lihat Harga.