Migrasikan ke label feed

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.

Anda dapat menggunakan kolom feedLabel untuk menambahkan label ke produk dan datafeed.

Label feed dapat memiliki format berikut:

• String jenis
• Kurang dari atau sama dengan 20 karakter
• Huruf besar (A-Z)
• Angka (0-9)
• Tanda hubung (-)

feedLabel tersedia dalam referensi berikut:

• products
• datafeeds
• datafeedstatuses

ID REST

feedLabel menggantikan targetCountry di ID REST untuk produk baru.

Sebagai ganti online:language:targetCountry:offerId, ID REST kini dibuat sebagai online:language:feedLabel:offerId untuk produk baru. ID REST produk yang sudah ada tidak berubah.

Mendapatkan dan membuat daftar produk

Kolom feedLabel selalu diisi untuk semua produk yang ditampilkan.

Jika feedLabel adalah kode wilayah CLDR yang valid, kami akan otomatis mengisi ulang kolom targetCountry agar kompatibel. Jika feedLabel bukan kode wilayah CLDR yang valid, biarkan targetCountry kosong.

Peringatan: Nilai targetCountry yang diisi ulang tidak memungkinkan produk Anda ditayangkan di negara yang disediakan. Pastikan semua negara yang ingin Anda targetkan disertakan dalam kolom shipping.

Perubahan yang sama berlaku untuk endpoint productstatuses.

Kolom khusus negara kosong untuk penawaran dengan feedLabel yang bukan kode wilayah CLDR.

Menyisipkan dan memperbarui produk

feedLabel atau targetCountry diperlukan untuk menyisipkan produk baru. Jika Anda menyisipkan atau memperbarui produk dengan feedLabel dan targetCountry, nilainya harus cocok.

Anda menerima error dari API jika kolom kosong, atau jika nilainya tidak cocok.

Lihat Menggunakan label feed untuk mengiklankan produk dari feed tertentu untuk mengetahui detail selengkapnya.

Penargetan negara

Gunakan salah satu dari hal berikut untuk memastikan produk Anda menargetkan negara yang tepat:

• Kolom shipping dari resource products
• Kolom targetCountries dari resource datafeeds

Produk

Kolom targetCountry untuk products tidak digunakan lagi. Sebagai gantinya, gunakan kolom shipping untuk menentukan negara target.

Jika ingin menargetkan beberapa negara, Anda dapat terus menggunakan shipping untuk menambahkan negara tambahan.

Lihat artikel Menargetkan iklan di beberapa negara untuk mengetahui informasi lebih lanjut.

Datafeed

Sekarang Anda dapat melihat negara mana yang ditargetkan secara eksplisit oleh datafeed di targets. Hal ini berlaku saat Anda menggunakan feedLabel, bukan country dalam konfigurasi datafeedtarget.

Kami juga telah menambahkan kolom targetCountries untuk datafeeds, sehingga Anda dapat mengonfigurasi penargetan untuk datafeeds secara langsung. Anda masih dapat mengonfigurasi penargetan di luar feed, misalnya, dengan menetapkan atribut shipping resource produk.

Konversi Inggris Raya ke GB

Saat ini, kami mengizinkan nilai UK untuk kolom targetCountry meskipun bukan kode negara yang valid. Kami otomatis mengonversi UK menjadi GB. Produk dengan UK sebagai targetCountry-nya disimpan dengan GB di REST ID dan offerId-nya.

Jika Anda menetapkan UK sebagai nilai untuk feedLabel, nilai tersebut tidak akan otomatis dikonversi menjadi GB. UK dan GB adalah string berbeda untuk feedLabel dan akan membuat penawaran yang berbeda.

Jika Anda memasukkan targetCountry dari UK, dan kita mengonversinya menjadi GB, Anda harus memperbarui ID REST produk untuk menyertakan GB, bukan UK, untuk mengambil produk dengan metode get.