Halaman ini menjelaskan cara mengupload dan mengelola produk secara terprogram. Dengan menggunakan Merchant Products API, Anda dapat menyisipkan atau memperbarui produk di sumber data, mengambil produk dari akun, dan menghapus produk dari sumber data.
Merchant Products API berisi dua resource.
productInputsmewakili bagian input produk Anda.productsmewakili produk yang diproses yang dibuat dari bagian input Anda.
productInputs dapat berupa utama dan tambahan, bergantung pada apakah data tersebut
diupload ke
sumber data utama
atau
sumber data tambahan.
Setiap product akan dibuat dari satu productInput utama dan sejumlah
productInputs tambahan.
Anda dapat menggunakan Merchant Products API untuk membuat katalog toko lokal atau
online, yaitu produk yang dapat muncul di
beberapa tujuan belanja.
Anda dapat menggunakan resource productInputs setelah membuat akun Merchant Center, menyiapkan sumber data pertama, dan siap mengupload kumpulan produk awal melalui API.
Meskipun penjual memiliki kemampuan untuk mengupload produk menggunakan file yang disebut PrimaryProductDataSource, ada beberapa keuntungan dalam membuat dan menghapus produk menggunakan Merchant API. Keuntungan ini mencakup waktu respons yang lebih cepat dan kemampuan untuk mengupdate produk secara real time, tanpa perlu mengelola file besar. Perlu waktu hingga beberapa jam agar perubahan produk yang dilakukan oleh panggilan API ditampilkan di database Shopping.
Prasyarat
Jika Anda tidak memiliki sumber data, buat sumber data menggunakan Merchant DataSources API atau Merchant Center.
Jika sudah memiliki sumber data yang dibuat menggunakan UI Merchant Center atau menggunakan API, Anda dapat menggunakan Merchant Products API untuk menambahkan produk. Jika Anda menggunakan Content API for Shopping untuk menambahkan produk, lihat panduan migrasi untuk memahami cara memulai dengan Merchant Products API.
Anda bertanggung jawab untuk mematuhi kebijakan Iklan Shopping dan listingan gratis. Iklan Shopping berhak menerapkan kebijakan ini dan merespons dengan tepat jika kami menemukan konten atau perilaku yang melanggar kebijakan ini.
Resource
Resource products memungkinkan Anda mengambil informasi produk dari database
Shopping.
Resource
productInput
mewakili data input yang Anda kirimkan untuk produk. API ini juga menyediakan
metode yang memungkinkan Anda memperbarui, atau menghapus informasi produk satu per satu, atau
banyak sekaligus dalam mode batch. Resource
productInput harus memiliki kolom berikut:
channel: Saluran produk.offerId: ID unik untuk produk.contentLanguage: Kode bahasa ISO 639-1 dua huruf untuk produk.feedLabel: Label feed untuk produk.
Mengupload input produk ke akun Anda
Untuk mengupload input produk ke akun Anda, gunakan metode accounts.productInputs.insert. Anda harus meneruskan
ID unik sumber data utama atau tambahan.
Mengambil produk yang telah diproses dari akun Anda
Untuk mengambil produk yang diproses dari akun Anda, gunakan metode accounts.products.get. Diperlukan waktu beberapa menit agar
produk yang diproses muncul setelah penyisipan.
Anda bisa mendapatkan nama resource produk yang diproses dari kolom product
dalam
respons accounts.productInputs.insert
Menghapus input produk dari akun Anda
Untuk menghapus input produk dari akun Anda, gunakan
metode accounts.productInputs.delete. Anda harus meneruskan
ID unik sumber data utama atau tambahan tempat produk
tersebut berada untuk menghapus produk menggunakan Merchant Products API.
Mencantumkan produk dari akun Anda
Untuk mencantumkan produk yang diproses di akun Anda, gunakan metode accounts.products.list.