Mengelola informasi katalog

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

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

Membuat, mengakses, dan mengelola tutorial produk

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

• Membuat produk
• Mendapatkan produk
• Memperbarui produk
• Menghapus produk

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

Pandu saya

Buat produk

Tutorial ini menunjukkan cara membuat satu produk.

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

Pandu saya

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:

Pandu saya

Memperbarui produk

Tutorial ini menunjukkan cara memperbarui produk dalam katalog.

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

Pandu saya

Hapus 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

Mengupload satu item produk

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"

{
  "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"
}

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

Memperbarui informasi produk

Saat katalog produk Anda berubah, Anda dapat memperbarui 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 -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"

{
  "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"
}

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 tidak dapat memproses peristiwa pengguna dengan benar dan peristiwa tersebut mungkin dihapus. Selain itu, menyertakan data katalog historis akan meningkatkan kualitas model Anda dan sangat penting untuk rekomendasi dan hasil penelusuran yang baik.

Anda harus menyetel availability produk yang sudah tidak berlaku ke OUT_OF_STOCK daripada menghapusnya.

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"

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

Mengambil item produk

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"

{
    "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"
}

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 di halaman Data di konsol Penelusuran untuk e-commerce.

Menilai kualitas data katalog

Untuk menilai kualitas data katalog Anda:

1. Buka halaman Kualitas data di konsol Penelusuran untuk e-commerce.
   
   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 Memanfaatkan tingkat performa penelusuran.

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

Mengubah tipe produk

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

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

Mengubah konfigurasi tingkat produk

Untuk mengimpor katalog dengan Merchant Center, Anda harus menentukan apakah produk tersebut adalah produk utama atau varian.

Jika tingkat produk berubah atau ditentukan secara salah, gunakan prosedur ini untuk mengoreksi konfigurasinya. Anda harus memiliki peran IAM Admin Retail untuk menyelesaikan prosedur ini.

1. Pastikan tidak ada impor yang sedang berlangsung saat Anda mengonfigurasi ulang tingkat produk. Hal ini memverifikasi bahwa 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 menyetel tingkat produk ke konfigurasi barunya.

4. Selesaikan pengimporan katalog baru dengan konfigurasi tingkat yang diubah, menggunakan prosedur yang Anda pilih di Mengimpor Informasi Katalog.

5. Sesuaikan semua model yang ada.

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

   Buka halaman Models

   Untuk mengetahui detail biaya penyesuaian, lihat Harga.