add_alert
Penting: Content API for Shopping akan dihentikan pada 18 Agustus 2026.
rocket
Perkenalkan
Merchant API
- pengganti resmi Content API for Shopping.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Error yang biasa terjadi
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Berikut adalah kesalahan yang paling umum:
Berikut adalah daftar error dalam urutan abjad.
auth/account_access_denied
User cannot access account
<account_number> |
|---|
| Ringkasan | Mengirim permintaan yang menargetkan 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 | NA |
User is not an administrator of
account <account_number> |
|---|
| Ringkasan | Mengirim permintaan untuk mengubah akun yang
penggunanya yang diautentikasi tidak memiliki hak admin. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Menetapkan hak admin untuk
pengguna yang diautentikasi. |
| Tips pencegahan | NA |
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 pada saat yang sama. |
| 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 serangkaian permintaan batch. Coba hindari beberapa panggilan serentak ke Content API untuk kode toko dan penjual yang sama, atau pastikan panggilan tersebut tidak berisi produk yang tumpang-tindih. |
internalError
Internal error |
|---|
| Ringkasan | Ada masalah dengan backend Google. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Coba lagi permintaan tersebut.
Hubungi kami
jika terus gagal. |
| Tips pencegahan | NA |
nggak valid
Invalid channel:
'<channel>' |
|---|
| Ringkasan | Saluran tidak valid yang diberikan sebagai bagian dari ID produk.
Misalnya: not_a_channel:en:US:sku123. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | NA |
| Tips pencegahan | Pastikan ID produk Anda dalam bentuk
channel:languageCode:countryCode:offerId, misalnya:
online:en:US:sku123. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi untuk
Products.insert. |
[countrycode] Invalid country code:
'<country_code>' |
|---|
| Ringkasan | Kode negara tidak valid yang diberikan sebagai bagian dari ID produk.
Misalnya: online:en:not_a_country_code:sku123. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | NA |
| Tips pencegahan | Pastikan ID produk Anda memiliki format
channel:languageCode:countryCode:offerId dan kode negara
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 | NA |
| 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 | NA |
| Tips penanganan yang direkomendasikan | Gunakan nama yang diizinkan.
Lihat artikel Pusat Bantuan Spesifikasi Feed untuk mengetahui informasi selengkapnya. |
| Tips pencegahan | NA |
[price.currency] Please use a currency
that is supported in the target country |
|---|
| Ringkasan | Menentukan mata uang yang tidak tersedia di
negara target. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Pastikan mata uang dan negara ditentukan dengan benar. Lihat
bagian
tentang price di artikel Pusat Bantuan Spesifikasi Feed
untuk mengetahui informasi selengkapnya. |
| Tips pencegahan | NA |
[storeCode] storeCode must be
'online' |
|---|
| Ringkasan | Mencoba memperbarui harga dan ketersediaan produk online melalui feed inventaris, tetapi menentukan sesuatu selain nilai khusus online sebagai ID toko di URL. |
| Penyebab umum | NA |
| 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 Anda. |
[<attribute>] |
|---|
| Ringkasan | Item yang ditentukan dalam tanda kurung siku tidak valid. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Perbaiki spesifikasi
item masalah, lihat
artikel Pusat Bantuan Spesifikasi Feed untuk mengetahui informasi selengkapnya. |
| Tips pencegahan | NA |
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
penghapusan. |
| Tips penanganan yang direkomendasikan | Dapatkan daftar
produk menggunakan
Products.list dan hanya coba mendapatkan, memperbarui, atau menghapus
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 | NA |
not_inserted
The item could not be
inserted. |
|---|
| Ringkasan | Karena error lainnya, produk tidak dapat dimasukkan
karena akan menggantikan entri valid yang ada. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Periksa error
lain untuk panggilan yang sama dan atasi sebelum mencoba menyisipkan
informasi produk baru. |
| Tips pencegahan | NA |
kuota
too_many_items: Merchant
quota exceeded |
|---|
| Ringkasan | Terlalu banyak item yang diupload ke Google Shopping. |
| Penyebab umum | Produk yang gagal divalidasi masih dapat dimasukkan, jika tidak menggantikan produk valid yang ada. Sebaiknya gunakan
flag includeInvalidInsertedItems untuk
Productstatuses.list guna memastikan akun Anda tidak memiliki
terlalu banyak produk tidak valid. |
| 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
tercapai, produk akan dihapus secara otomatis. Perlu diingat bahwa tanggal habis masa berlaku default,
dan maksimum adalah 30 hari setelah penyisipan atau pembaruan produk.
Catatan: Kuota item untuk akun multiklien diperiksa berdasarkan jumlah total produk di semua sub-akun. Jika Anda mendapatkan error ini dengan sub-akun, pastikan
sub-akun dan MCA Anda memiliki kuota produk yang cukup.
Jika Anda telah 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 telah mencapai jumlah maksimum sub-akun yang diizinkan
untuk akun multiklien Anda. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Menghapus 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 | NA |
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 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 meluas 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 penundaan terprogram untuk mengurangi
kecepatan permintaan ke tingkat yang sesuai dan berkelanjutan. |
daily_limit_exceeded:
merchant quota exceeded |
|---|
| Ringkasan | Anda membuat lebih banyak permintaan per hari daripada jumlah yang diizinkan untuk metode layanan tertentu. |
| Penyebab umum | Lihat kuota per hari yang tercantum dalam
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 pada produk selama jangka waktu yang sesuai untuk menghindari perubahan produk beberapa kali secara cepat. Untuk pembaruan item yang dapat ditampilkan sebagai microdata di situs Anda, pertimbangkan untuk menggunakan pendekatan tersebut guna membatasi jumlah panggilan ke layanan Products atau Inventory.
Jika Anda masih memerlukan lebih banyak panggilan harian ke metode tertentu, hubungi kami dan beri tahu kami ID Merchant Center Anda, metode yang mencapai batas kuota, perkiraan jumlah panggilan per hari yang Anda perlukan untuk metode tersebut dan alasannya, dan kami akan bekerja sama dengan Anda untuk menaikkan kuota Anda. |
| 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 tidak dapat Anda akses. |
| 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 dihapus. |
| Tips pencegahan | Lihat Tips penanganan yang direkomendasikan. |
request_too_large |
|---|
| Ringkasan | Anda mengirim terlalu banyak entries per permintaan batch, atau
melebihi batas ukuran permintaan custombatch. |
| Penyebab umum | Anda dapat menyertakan maksimal 10.000 entries per
permintaan custombatch, dan batas ukuran transfer yang dikompresi adalah 32 Mb. |
| Tips penanganan yang direkomendasikan | Pisahkan batch menjadi beberapa batch yang berada di bawah batas, lalu coba lagi. |
| Tips pencegahan | Sebaiknya jangan mengirim 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 | NA |
| Tips penanganan yang direkomendasikan | Pastikan
parameter, di sini
price, diformat dengan benar. Misalnya,
price memiliki dua kolom wajib: value dan
currency. |
| Tips pencegahan | NA |
[product] INSERT request must specify
product |
|---|
| Ringkasan | Mengirimkan permintaan batch kustom ke API
yang berisi entri dengan "method": "insert", tetapi tidak ada produk. |
| Penyebab umum | Lupa mengubah metode menjadi 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 | Mengirimkan permintaan batch kustom ke API yang berisi entri dengan "method": "delete", tetapi tidak ada ID produk. |
| Penyebab umum | Lupa mengubah metode menjadi
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 meluas ke jumlah
thread yang lebih besar. |
| Tips penanganan yang direkomendasikan | Kurangi total permintaan
yang dikirim per menit. Mengelompokkan beberapa panggilan metode ke layanan yang sama menjadi
satu permintaan custombatch akan mengurangi jumlah permintaan HTTP yang dilakukan. |
| Tips pencegahan | Saat Anda menerima error ini, gunakan strategi batching dan
back-off terprogram untuk mengurangi kecepatan permintaan Anda ke tingkat
berkelanjutan yang sesuai. |
validasi
[adwords_redirect] |
|---|
| Ringkasan | Mengirimkan produk yang kolom adwords_redirect
bukan URL yang valid. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Pastikan nilai
kolom
adwords_redirect adalah URL yang valid. |
| Tips pencegahan | NA |
[item] auth/frontend/not_claimed |
|---|
| Ringkasan | URL situs penjual belum diklaim di Merchant Center. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Klaim URL di
Merchant Center. Prosedur
mendetail untuk melakukannya tersedia di
Pusat
Bantuan. |
| Tips pencegahan | NA |
[energy_efficiency_class]
validation/feed |
|---|
| Ringkasan | Menentukan harga unit energyEfficiencyClass
dan
untuk produk yang sama. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Tentukan hanya
tingkat efisiensi energi atau harga per unit, bukan keduanya. |
| Tips pencegahan | NA |
[item] internal |
|---|
| Ringkasan | Error internal. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Coba lagi permintaan tersebut.
Hubungi kami
jika terus gagal. |
| Tips pencegahan | NA |
[item_group_id] invalid_attribute |
|---|
| Ringkasan | Mengirimkan item dengan itemGroupId
dan banyak nilai untuk atribut varian (warna, ukuran, pola, atau bahan). |
| Penyebab umum | Menentukan lebih dari satu ukuran untuk produk
sekaligus menentukan ID kelompok item. |
| Tips penanganan yang direkomendasikan | Kirimkan produk yang berbeda untuk setiap nilai atribut varian tertentu, seperti
size. |
| Tips pencegahan | NA |
[additional_image_link]
invalid_attribute |
|---|
| Ringkasan | Mengirimkan lebih dari 10 link gambar tambahan. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Batasi jumlah
link gambar tambahan hingga 10. |
| Tips pencegahan | NA |
[<attribute>] invalid_character |
|---|
| Ringkasan | Mengirimkan merek, deskripsi, atau atribut lain
sebagai string yang tidak diuraikan menggunakan encoding permintaan yang ditentukan. |
| Penyebab umum | NA |
| 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 | NA |
[<attribute>] invalid_value |
|---|
| Ringkasan | Mengirimkan warna, deskripsi, atau atribut lain yang tidak valid. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Pastikan semua atribut mematuhi spesifikasi feed, lihat artikel Pusat Bantuan Spesifikasi Feed untuk mengetahui informasi selengkapnya. Untuk masalah GTIN atau MPN, lihat
artikel Pusat Bantuan Kode unik produk. |
| Tips pencegahan | NA |
[<attribute>]
missing_recommended/missing_required |
|---|
| Ringkasan | Mengirimkan produk tanpa atribut wajib/direkomendasikan. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Pastikan Anda menyertakan
semua atribut yang direkomendasikan / wajib untuk produk Anda. Lihat
artikel Pusat Bantuan Spesifikasi Feed untuk mengetahui informasi selengkapnya. |
| Tips pencegahan | NA |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|---|
| Ringkasan | Mengirimkan produk dengan URL dasar yang berbeda
dari URL yang diklaim oleh akun Merchant Center. |
| Penyebab umum | NA |
| Tips penanganan yang direkomendasikan | Pastikan URL
untuk produk yang dikirimkan cocok dengan
situs
yang diklaim oleh Merchant Center. |
| Tips pencegahan | NA |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2026-07-06 UTC.
[null,null,["Terakhir diperbarui pada 2026-07-06 UTC."],[],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]