ID Produk

Kami ingin memperkenalkan Merchant API versi beta. Versi baru ini adalah Content API for Shopping dan masa depan.

Untuk informasi tentang cara Merchant API dapat meningkatkan integrasi Anda dan cara membantu membentuk masa depan, lihat Mengumumkan Merchant API Beta.

Berikut berbagai jenis ID produk di Content API for Shopping:

ID Penawaran

offerId adalah string yang ditetapkan ke produk oleh penjual. ID ini mewakili sebuah produk.

offerId bersifat unik untuk kumpulan penawaran di database Merchant Center, dan biasanya berupa nomor urut numerik.

offerId dapat berupa nomor SKU internal yang ditetapkan penjual untuk produk.

ID REST

ID REST adalah ID unik untuk produk yang ditetapkan oleh Google.

ID REST adalah productId untuk panggilan REST API.

ID REST adalah gabungan dengan format online:en:label:1111111111. ID REST terdiri dari 4 bagian berikut, yang dipisahkan oleh titik dua:

1. Saluran ("online" atau "lokal")
2. Bahasa Konten (menggunakan pengelompokan 2 huruf, misalnya en atau fr)
3. Label feed (dapat berupa kode dua huruf untuk negara target feed, misalnya US atau FR)
4. ID Penawaran

Anda menyatukannya sebagai channel:contentLanguage:feedLabel:offerId, misalnya, online:en:US:1111111111.

ID Penjual Eksternal (Marketplace)

Marketplace harus menetapkan external_seller_id untuk penawaran yang diupload ke akun multi-penjual. Kolom ini mewakili masing-masing penjual.

Nilai external_seller_id peka huruf besar/kecil dan harus memenuhi kriteria berikut:

• Panjangnya antara 1-50 karakter
• Hanya karakter ASCII alfanumerik, garis bawah (_), tanda hubung (-), titik (.), dan tanda gelombang (~)

Kolom ini tidak sama dengan kolom seller_id internal.

Tabel berikut merangkum beberapa ID yang dapat dikaitkan dengan produk:

Atribut	Deskripsi	Contoh	Catatan
offerId	ID yang ditetapkan ke produk oleh penjual.	1111111111	Jenis data string, ID unik untuk penawaran produk.
ID REST	ID yang ditetapkan ke produk oleh Google. Dalam format channel:contentLanguage:feedLabel:offerId.	online:en:label:1111111111	ID lengkap termasuk offerId.
productId	Digunakan untuk merujuk ke REST ID dalam panggilan API.	online:en:label:1111111111	Ini adalah REST ID produk.
id	Nilai sama seperti REST ID dan productId.	online:en:label:1111111111	Digunakan di dalam isi JSON produk untuk merujuk ke productId-nya.
external_seller_id	ID penjual yang dipilih oleh Marketplace.	example-Seller1	Wajib untuk akun multi-penjual. Harus terdiri dari 1-50 karakter. Peka huruf besar-kecil. Angka, dan karakter khusus _, -, ., dan ~ diterima.