Perkenalkan Merchant API - pengganti resmi Content API for Shopping.

Dapatkan info terbaru tentang fitur, perbaikan bug, dan update Merchant API baru.

Mulai menggunakan Merchant API dan dapatkan akses ke data, insight, dan kemampuan unik dalam skala besar.

Catatan: Content API for Shopping akan dihentikan pada 18 Agustus 2026.

Halaman ini diterjemahkan oleh Cloud Translation API.

Error yang biasa terjadi

Berikut adalah error yang paling umum:

notFound: Item tidak ditemukan.
not_inserted: Item tidak dapat disisipkan.
[link] validation/invalid_value for <destinations>: URL bukan bagian dari situs Anda.
quota/too_many_items: Kuota penjual terlampaui.

Berikut adalah daftar kesalahan dalam urutan abjad.

{i>auth/account_access_denied<i}

`User cannot access account <account_number>`
Ringkasan	Mengirimkan permintaan yang menarget akun yang tidak dapat diakses oleh pengguna terautentikasi.
Penyebab umum	Terjadi error pada ID penjual target atau lupa mendaftarkan pengguna di Merchant Center.
Tips penanganan yang direkomendasikan	Pastikan Anda menargetkan akun yang tepat atau mendaftarkan diri sebagai pengguna akun di Merchant Center (Setelan > Pengguna).
Tips pencegahan	TA
`User is not an administrator of account <account_number>`
Ringkasan	Mengajukan permintaan untuk mengubah akun yang hak adminnya tidak dimiliki oleh pengguna yang diautentikasi.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Tetapkan hak admin untuk pengguna terautentikasi.
Tips pencegahan	TA

konflik

`[productId] Product ID <product id> is already modified by another entry in the same request for merchant <merchant> and store code <store code>`
Ringkasan	Mencoba beberapa operasi yang bertentangan secara bersamaan.
Penyebab umum	Satu permintaan batch berisi beberapa operasi yang bertentangan untuk produk yang sama, atau beberapa operasi yang bertentangan untuk produk yang sama dikirimkan ke Content API secara bersamaan.
Tips penanganan yang direkomendasikan	Lihat tips pencegahan.
Tips pencegahan	Berisi semua perubahan untuk produk tertentu ke satu operasi dalam kumpulan permintaan batch. Cobalah untuk menghindari beberapa panggilan serentak ke Content API untuk penjual dan kode toko yang sama, atau pastikan panggilan tersebut tidak berisi produk yang tumpang-tindih.

internalError

`Internal error`
Ringkasan	Ada masalah dengan backend Google.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Coba lagi permintaan tersebut. Hubungi kami jika terus-menerus gagal.
Tips pencegahan	TA

nggak valid

`Invalid channel: '<channel>'`
Ringkasan	Channel yang diberikan sebagai bagian dari ID produk tidak valid. Misalnya: `not_a_channel:en:US:sku123`.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	TA
Tips pencegahan	Pastikan ID produk Anda memiliki format `channel:languageCode:countryCode:offerId`, misalnya: `online:en:US:sku123`. Untuk informasi selengkapnya, lihat dokumentasi referensi untuk `Products.insert`.
`[countrycode] Invalid country code: '<country_code>'`
Ringkasan	Kode negara yang diberikan sebagai bagian dari ID produk yang tidak valid. Misalnya: `online:en:not_a_country_code:sku123`.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	TA
Tips pencegahan	Pastikan ID produk Anda berupa `channel:languageCode:countryCode:offerId` dan kode negaranya adalah kode negara ISO 3166 yang valid.
`[item id] Invalid item id: '<id>'`
Ringkasan	ID item tidak valid, misalnya, `sku123`, bukan `online:en:US:sku123`.
Penyebab umum	Menentukan ID penawaran, bukan ID produk, dalam permintaan `GET` atau `DELETE`.
Tips penanganan yang direkomendasikan	TA
Tips pencegahan	Pastikan ID produk Anda memiliki format `channel:languageCode:countryCode:offerId`.
`[name] The term '<term>' is not allowed`
Ringkasan	Nama berisi kata yang dilarang.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Gunakan nama yang diizinkan. Baca artikel Pusat Bantuan Spesifikasi Feed untuk informasi selengkapnya.
Tips pencegahan	TA
`[price.currency] Please use a currency that is supported in the target country`
Ringkasan	Menyatakan mata uang yang tidak tersedia di negara target.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Pastikan mata uang dan negara ditetapkan dengan benar. Lihat bagian tentang `price` di artikel Pusat Bantuan Spesifikasi Feed untuk informasi selengkapnya.
Tips pencegahan	TA
`[storeCode] storeCode must be 'online'`
Ringkasan	Mencoba memperbarui harga dan ketersediaan produk online melalui feed inventaris, tetapi menentukan sesuatu yang lain selain nilai khusus `online` sebagai ID toko di URL.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Ubah ID toko menjadi `online` di URL permintaan.
Tips pencegahan	Pastikan Anda menentukan `online` untuk produk online dan ID toko untuk produk lokal di semua kueri inventaris.
`[<attribute>]`
Ringkasan	Item yang ditentukan dalam tanda kurung siku tidak valid.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Perbaiki spesifikasi item masalah, lihat artikel Pusat Bantuan Spesifikasi Feed untuk informasi lebih lanjut.
Tips pencegahan	TA

notFound

`Item not found`
Ringkasan	Item yang Anda coba dapatkan, perbarui, atau hapus tidak ada.
Penyebab umum	Mencoba menghapus produk yang tidak ada, atau tidak menentukan ID produk dengan benar di URL untuk dihapus.
Tips penanganan yang direkomendasikan	Dapatkan daftar produk menggunakan `Products.list` dan hanya coba dapatkan, perbarui, atau hapus item yang muncul di sana. Pastikan Anda menentukan ID produk dalam bentuk `channel:languageCode:countryCode:offerId`, misalnya: `online:ru:RU:277104-ekb`, bukan ID penawaran, yang terlihat seperti ini: `277104-ekb`.
Tips pencegahan	TA

not_inserted

`The item could not be inserted.`
Ringkasan	Karena error lainnya, produk tidak dapat dimasukkan karena akan menimpa entri baik yang sudah ada.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Periksa error lainnya untuk panggilan yang sama dan atasi error tersebut sebelum mencoba memasukkan kembali informasi produk baru.
Tips pencegahan	TA

kuota

`too_many_items: Merchant quota exceeded`
Ringkasan	Terlalu banyak item yang diupload ke Google Shopping.
Penyebab umum	Produk yang gagal divalidasi tetap dapat dimasukkan, jika tidak menggantikan produk valid yang sudah ada. Pertimbangkan untuk menggunakan tanda `includeInvalidInsertedItems` pada `Productstatuses.list` untuk memastikan akun Anda tidak memiliki produk yang tidak valid dalam jumlah berlebihan.
Tips penanganan yang direkomendasikan	Periksa dan hapus produk tidak valid dalam jumlah berlebihan seperti yang disebutkan di atas. Selain itu, tentukan tanggal habis masa berlaku saat mengupload produk. Saat tanggal habis masa berlaku habis, produk akan otomatis dihapus. Perhatikan bahwa tanggal habis masa berlaku default dan maksimum adalah 30 hari setelah penyisipan atau pembaruan produk. Catatan: Kuota item untuk akun multiklien dicocokkan dengan jumlah total produk di semua sub-akun. Jika Anda mendapatkan error ini terkait sub-akun, pastikan sub-akun dan MCA Anda memiliki kuota produk yang cukup. Jika sudah mencoba solusi ini dan masih kehabisan ruang untuk produk baru di akun Merchant Center, Anda dapat meminta kemampuan untuk mengirimkan lebih banyak item di akun Anda.
Tips pencegahan	Lihat Tips penanganan yang direkomendasikan.
`too_many_subaccounts: Maximum number of subaccounts reached`
Ringkasan	Anda memiliki jumlah sub-akun maksimum yang diizinkan untuk akun multiklien.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Hapus sub-akun yang sudah tidak digunakan. Jika semua akun Anda aktif, Anda dapat meminta kemampuan untuk membuat sub-akun tambahan di MCA Anda.
Tips pencegahan	TA
`request_rate_too_high: Request rate too high. Please reduce your throughput`
Ringkasan	Permintaan dibuat terlalu cepat, kurangi frekuensi permintaan.
Penyebab umum	Lihat kuota per menit yang tercantum di batas yang dipublikasikan. Jika Anda melebihi nilai minimum ini, Anda akan menerima error ini. Terkadang ada lonjakan traffic yang menyebabkan hal ini, atau server Anda diperluas ke jumlah thread yang lebih besar.
Tips penanganan yang direkomendasikan	Kurangi total permintaan yang dikirim per menit.
Tips pencegahan	Saat Anda menerima error ini, gunakan strategi back-off terprogram untuk mengurangi rasio permintaan Anda ke tingkat berkelanjutan yang sesuai.
`daily_limit_exceeded: merchant quota exceeded`
Ringkasan	Anda membuat lebih dari jumlah permintaan yang diizinkan per hari untuk metode layanan tertentu.
Penyebab umum	Lihat kuota per hari yang tercantum di batas yang dipublikasikan. Jika Anda melebihi nilai minimum ini, Anda akan menerima error ini.
Tips penanganan yang direkomendasikan	Kurangi total permintaan yang dikirim per hari dengan menggabungkan beberapa perubahan menjadi satu permintaan jika memungkinkan. Pertimbangkan untuk mengelompokkan perubahan produk selama jangka waktu yang tepat agar produk tidak berubah dengan cepat beberapa kali. Untuk pembaruan item yang dapat direpresentasikan sebagai mikrodata di situs Anda, pertimbangkan untuk menggunakan pendekatan tersebut guna membatasi jumlah panggilan ke layanan `Products` atau `Inventory`. Jika Anda masih membutuhkan lebih banyak panggilan harian ke metode tertentu, hubungi kami dan beri tahu kami ID Merchant Center Anda, metode mana yang telah mencapai batas kuota, perkiraan jumlah panggilan per hari yang Anda perlukan untuk metode tersebut, dan alasannya, dan kami akan bekerja sama dengan Anda untuk meningkatkan kuota.
Tips pencegahan	Lihat Tips penanganan yang direkomendasikan.
`too_many_failed_auths: Too many failed authentications.`
Ringkasan	Anda membuat terlalu banyak permintaan batch untuk akun yang aksesnya tidak Anda miliki.
Penyebab umum	Membuat permintaan dalam batch untuk sub-akun yang telah dihapus atau untuk sub-akun yang baru dibuat sebelum tersedia.
Tips penanganan yang direkomendasikan	Hindari melakukan panggilan yang memengaruhi sub-akun yang telah dihapus.
Tips pencegahan	Lihat Tips penanganan yang direkomendasikan.
`request_too_large`
Ringkasan	Anda mengirimkan terlalu banyak `entries` per permintaan batch, atau melebihi batas ukuran permintaan `custombatch`.
Penyebab umum	Anda dapat menyertakan maksimum 10.000 `entries` per permintaan `custombatch`, dan batas ukuran transfer terkompresi adalah 32 Mb.
Tips penanganan yang direkomendasikan	Bagi batch menjadi beberapa batch yang berada di bawah batas, lalu coba lagi.
Tips pencegahan	Sebaiknya kirimkan tidak lebih dari 1.000 entri per batch.

wajib diisi

`[price.value] Required parameter: price.value`
Ringkasan	Menentukan harga tanpa nilai. Misalnya: `{ "currency": "USD" }`, bukan `{ "value": 123, "currency": "USD" }`.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Pastikan parameter, di sini `price`, diformat dengan benar. Misalnya, `price` memiliki dua kolom wajib: `value` dan `currency`.
Tips pencegahan	TA
`[product] INSERT request must specify product`
Ringkasan	Mengirim permintaan batch kustom ke API yang berisi entri dengan `"method": "insert"`, tetapi tidak ada produk.
Penyebab umum	Lupa mengubah metode ke `get` atau `delete`.
Tips penanganan yang direkomendasikan	Tentukan produk yang akan disisipkan melalui kolom `product`.
Tips pencegahan	Pastikan entri batch dengan metode `insert` menentukan produk, dan entri batch dengan metode `get` atau `delete` menentukan ID produk.
`[productId] DELETE request must specify productId`
Ringkasan	Mengirim permintaan batch kustom ke API yang berisi entri dengan `"method": "delete"`, tetapi tidak ada ID produk.
Penyebab umum	Lupa mengubah metode ke `insert`.
Tips penanganan yang direkomendasikan	Tentukan produk yang akan dihapus melalui kolom `productID`.
Tips pencegahan	Pastikan entri batch dengan metode `insert` menentukan produk, dan entri batch dengan metode `get` atau `delete` menentukan ID produk.

userRateLimitExceeded

`User Rate Limit Exceeded`
Ringkasan	Permintaan dibuat terlalu cepat, kurangi frekuensi permintaan.
Penyebab umum	Lihat batas permintaan HTTP yang tercantum dalam batas yang dipublikasikan. Jika Anda melebihi nilai minimum ini, Anda akan menerima error ini. Terkadang ada lonjakan traffic yang menyebabkan hal ini, atau server Anda memperluas jumlah thread yang lebih besar.
Tips penanganan yang direkomendasikan	Kurangi total permintaan yang dikirim per menit. Mengelompokkan beberapa panggilan metode ke layanan yang sama ke dalam satu permintaan `custombatch` akan menurunkan jumlah permintaan HTTP yang dibuat.
Tips pencegahan	Saat Anda menerima error ini, gunakan strategi back-off pengelompokan dan back-off terprogram untuk mengurangi rasio permintaan ke tingkat berkelanjutan yang sesuai.

validasi

`[adwords_redirect]`
Ringkasan	Mengirim produk dengan kolom `adwords_redirect` bukan URL yang valid.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Pastikan nilai kolom `adwords_redirect` berupa URL yang valid.
Tips pencegahan	TA
`[item] auth/frontend/not_claimed`
Ringkasan	URL situs penjual belum diklaim di Merchant Center.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Klaim URL di Merchant Center. Prosedur mendetail untuk melakukannya tersedia di Pusat Bantuan.
Tips pencegahan	TA
`[energy_efficiency_class] validation/feed`
Ringkasan	Menentukan `energyEfficiencyClass` dan harga unit untuk produk yang sama.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Tentukan hanya tingkat efisiensi energi atau harga unit, bukan keduanya.
Tips pencegahan	TA
`[item] internal`
Ringkasan	Error internal.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Coba lagi permintaan tersebut. Hubungi kami jika terus-menerus gagal.
Tips pencegahan	TA
`[item_group_id] invalid_attribute`
Ringkasan	Mengirim item dengan `itemGroupId` dan banyak nilai untuk atribut varian (warna, ukuran, pola, atau bahan).
Penyebab umum	Menentukan lebih dari satu ukuran untuk satu produk sambil menentukan id kelompok item.
Tips penanganan yang direkomendasikan	Kirimkan produk yang berbeda untuk setiap nilai atribut varian tertentu, seperti `size`.
Tips pencegahan	TA
`[additional_image_link] invalid_attribute`
Ringkasan	Mengirimkan lebih dari 10 link gambar tambahan.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Batasi jumlah link gambar tambahan hingga 10.
Tips pencegahan	TA
`[<attribute>] invalid_character`
Ringkasan	Dikirim merek, deskripsi, atau atribut lainnya sebagai string yang tidak diurai menggunakan encoding permintaan yang ditentukan.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Periksa pesan untuk mengetahui atribut mana yang menyebabkan masalah, lalu validasi encoding teks dari nilai yang sesuai sebelum mengirim ulang. API hanya menerima karakter UTF-8 yang valid.
Tips pencegahan	TA
`[<attribute>] invalid_value`
Ringkasan	Mengirimkan warna, deskripsi, atau atribut lainnya yang tidak valid.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Memastikan semua atribut mematuhi spesifikasi feed, baca artikel Pusat Bantuan Spesifikasi Feed untuk mengetahui informasi selengkapnya. Untuk masalah GTIN atau MPN, lihat artikel Pusat Bantuan kode unik produk.
Tips pencegahan	TA
`[<attribute>] missing_recommended` / `missing_required`
Ringkasan	Mengirimkan produk tanpa atribut yang diperlukan/direkomendasikan.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Pastikan Anda menyertakan semua atribut yang direkomendasikan / wajib untuk produk Anda. Baca artikel Pusat Bantuan Spesifikasi Feed untuk informasi selengkapnya.
Tips pencegahan	TA
`[link] validation/invalid_value for <destinations>: URLs do not belong to your website`
Ringkasan	Mengirimkan produk dengan URL dasar yang berbeda dengan URL yang diklaim oleh akun Merchant Center.
Penyebab umum	TA
Tips penanganan yang direkomendasikan	Pastikan URL untuk produk yang dikirimkan cocok dengan situs yang diklaim oleh Merchant Center.
Tips pencegahan	TA