English
Deutsch
Español – América Latina
Français
Indonesia
Italiano
Português – Brasil
中文 – 简体
日本語
한국어

Hubungi Kami Mulai gratis

Retail diganti namanya menjadi Vertex AI Search untuk retail. Kami sedang dalam proses memperbarui konten untuk mencerminkan branding baru ini.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola informasi katalog

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

Agar katalog Anda selalu diperbarui seiring perubahan informasi produk, impor katalog dengan cara yang sama seperti saat pertama kali. Untuk mendapatkan bantuan terkait cara mengimpor katalog, lihat Mengimpor informasi katalog.

Tutorial membuat/mendapatkan/memperbarui/menghapus produk

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

Membuat produk
Mendapatkan produk
Memperbarui produk
Hapus produk

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

Tutorial membuat produk

Tutorial ini menunjukkan cara membuat satu produk.

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

Tutorial mendapatkan produk

Tutorial ini menunjukkan cara mengambil item produk.

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

Tutorial memperbarui 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:

Tutorial menghapus 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:

Mengupload 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
  );
}

Memperbarui informasi produk

Saat katalog produk berubah, Anda dapat memuat ulang katalog dengan mengupload perubahan pada 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, perlu diingat bahwa jika Anda merekam peristiwa pengguna yang terkait dengan item produk yang telah dihapus, API tidak dapat memproses peristiwa pengguna dengan benar dan mungkin akan dihapus. Selain itu, menyertakan data katalog historis akan meningkatkan kualitas model Anda dan sangat penting untuk rekomendasi dan hasil penelusuran yang baik.

Anda harus menetapkan availability produk usang ke OUT_OF_STOCK, bukan menghapusnya.

curl

Hapus produk menggunakan metode delete, ganti PRODUCT_ID dengan ID produk yang ingin Anda hapus.

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, dengan 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 di konsol Penelusuran untuk Retail.

Menilai kualitas data katalog

Untuk menilai kualitas data katalog Anda:

Buka halaman Kualitas data di konsol Penelusuran untuk Retail.

Buka halaman Kualitas data

Halaman Kualitas data akan 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 Memanfaatkan tingkat performa penelusuran.

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

Mengubah jenis produk

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

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

Mengubah konfigurasi tingkat produk

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

Pastikan tidak ada impor yang terjadi saat Anda mengonfigurasi ulang tingkat produk. Hal ini memastikan data tidak diupload di tingkat yang salah.
Menghapus 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 Impor Informasi Katalog untuk menetapkan tingkat produk ke konfigurasi barunya.
Selesaikan impor katalog baru dengan konfigurasi tingkat yang diubah, menggunakan prosedur yang Anda pilih di Mengimpor Informasi Katalog.
Menyesuaikan semua model yang ada.

Untuk menyesuaikan model, buka halaman Model, klik nama model untuk melihat halaman detailnya, lalu klik Manual Tune di panel tombol.

Buka halaman Model

Untuk mengetahui detail biaya penyesuaian, lihat Harga.

Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.

Terakhir diperbarui pada 2024-12-21 UTC.