Method: accounts.productInputs.insert

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

string

Wajib. Akun tempat produk ini akan dimasukkan. Format: accounts/{account}

Parameter kueri

Parameter
dataSource

string

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: accounts/{account}/dataSources/{datasource}.

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 (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
Kolom
name

string

ID. Nama input produk. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Hanya output. Nama produk yang diproses. Format: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Wajib. Tidak dapat diubah. Saluran produk.
offerId

string

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

string

Wajib. Tidak dapat diubah. Kode bahasa dua huruf ISO 639-1 untuk produk.
feedLabel

string

Wajib. Tidak dapat diubah. Label feed untuk produk.
attributes

object (Attributes)

Opsional. Daftar atribut produk.
customAttributes[]

object (CustomAttribute)

Opsional. Daftar atribut khusus (disediakan penjual). Atribut ini juga dapat digunakan untuk mengirimkan atribut spesifikasi data apa pun dalam bentuk generiknya (misalnya, { "name": "size type", "value": "regular" }). Hal ini berguna untuk mengirimkan atribut yang tidak diekspos secara eksplisit oleh API, seperti atribut tambahan yang digunakan untuk Beli dengan Google. Jumlah karakter maksimum yang diizinkan untuk setiap atribut khusus adalah 10240 (mewakili jumlah karakter untuk nama dan nilai). Maksimum 2.500 atribut khusus dapat ditetapkan per produk, dengan ukuran total 102,4 kB. Garis bawah pada nama atribut khusus diganti dengan spasi saat penyisipan.
versionNumber

string (int64 format)

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 versionNumber saat ini.

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.