Mengupload input produk ke akun Merchant Center Anda. Jika input dengan contentLanguage, offerId, dan dataSource yang sama sudah ada, metode ini akan menggantikan entri tersebut.
Setelah memasukkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk yang diproses dapat diambil.
Permintaan HTTP
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
parent |
Wajib. Akun tempat produk ini akan dimasukkan. Format: accounts/{account} |
Parameter kueri
Parameter | |
---|---|
dataSource |
Wajib. Nama sumber data produk utama atau tambahan. Jika produk sudah ada dan sumber data yang diberikan berbeda, produk tersebut akan dipindahkan ke sumber data baru. Format: |
Isi permintaan
Isi permintaan memuat instance ProductInput
.
Isi respons
Resource ini menunjukkan data input yang Anda kirimkan untuk suatu produk, bukan produk yang diproses yang Anda lihat di Merchant Center, di iklan Shopping, atau di seluruh platform Google. Input produk, aturan, dan data sumber data tambahan digabungkan untuk membuat [product][google.shopping.content.bundles.Products.Product] yang diproses.
Atribut input produk yang diperlukan untuk lulus pemeriksaan validasi data terutama didefinisikan dalam Spesifikasi Data Produk.
Atribut berikut wajib ada: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] dan [offerId][google.shopping.content.bundles.Products.offer_id].
Setelah memasukkan, memperbarui, atau menghapus input produk, mungkin perlu waktu beberapa menit sebelum produk yang diproses dapat diambil.
Semua kolom dalam input produk dan sub-pesannya cocok dengan nama bahasa Inggris dari atribut yang sesuai di spesifikasi vertical dengan beberapa pengecualian.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "name": string, "product": string, "channel": enum ( |
Kolom | |
---|---|
name |
ID. Nama input produk. Format: |
product |
Hanya output. Nama produk yang diproses. Format: |
channel |
Wajib. Tidak dapat diubah. Saluran produk. |
offerId |
Wajib. Tidak dapat diubah. ID unik produk. Ini sama dengan input produk dan produk yang diproses. Spasi di awal dan di akhir akan dihapus dan beberapa spasi kosong akan diganti dengan satu spasi kosong saat pengiriman. Lihat spesifikasi data produk untuk mengetahui detailnya. |
contentLanguage |
Wajib. Tidak dapat diubah. Kode bahasa dua huruf ISO 639-1 untuk produk. |
feedLabel |
Wajib. Tidak dapat diubah. Label feed untuk produk. |
attributes |
Opsional. Daftar atribut produk. |
customAttributes[] |
Opsional. Daftar atribut khusus (disediakan penjual). Atribut ini juga dapat digunakan untuk mengirimkan atribut spesifikasi data apa pun dalam bentuk generiknya (misalnya, |
versionNumber |
Opsional. Mewakili versi (keaktualan) produk yang ada, yang dapat digunakan untuk mempertahankan urutan yang benar saat beberapa update dilakukan secara bersamaan. Jika ditetapkan, penyisipan akan dicegah jika nomor versi lebih rendah dari nomor versi produk yang sudah ada saat ini. Penyisipan ulang (misalnya, pembaruan produk setelah 30 hari) dapat dilakukan dengan Hanya didukung untuk penyisipan ke sumber data utama. Jika operasi dicegah, pengecualian yang dibatalkan akan ditampilkan. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/content
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.