Mengeluarkan 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
Mengeluarkan permintaan untuk mengubah akun yang tidak memiliki hak admin bagi pengguna yang diautentikasi.
Penyebab umum
NA
Tips penanganan yang direkomendasikan
Tetapkan 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 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 yang dikelompokkan. Coba hindari beberapa
panggilan serentak ke Content API untuk kode penjual dan toko 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 yang diberikan tidak valid 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 berupa
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 yang diberikan sebagai bagian dari ID produk tidak valid.
Misalnya: online:en:not_a_country_code:sku123.
Penyebab umum
NA
Tips penanganan yang direkomendasikan
NA
Tips pencegahan
Pastikan ID produk Anda dalam bentuk
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.
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.
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 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
NA
not_inserted
The item could not be
inserted.
Ringkasan
Karena error lainnya, produk tidak dapat disisipkan
karena akan menimpa entri yang baik yang ada.
Penyebab umum
NA
Tips penanganan yang direkomendasikan
Periksa error
lainnya untuk panggilan yang sama dan atasi sebelum mencoba memasukkan ulang
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 mungkin masih dapat dimasukkan, jika tidak menggantikan produk valid yang ada. Sebaiknya gunakan flag includeInvalidInsertedItems ke Productstatuses.list untuk memastikan akun Anda tidak memiliki terlalu banyak produk yang tidak valid.
Tips penanganan yang direkomendasikan
Periksa dan
hapus produk tidak valid yang jumlahnya berlebihan seperti yang disebutkan di atas. Selain itu, tentukan
tanggal habis masa berlaku saat mengupload produk. Setelah tanggal habis masa berlaku
tercapai, produk akan otomatis dihapus. 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.
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 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 backoff terprogram untuk mengurangi
kapasitas permintaan ke tingkat yang berkelanjutan dan 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 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 secara cepat beberapa kali. Untuk pembaruan item
yang dapat direpresentasikan 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 kuotanya telah tercapai,
estimasi 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 Anda miliki aksesnya.
Penyebab umum
Membuat permintaan secara massal 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 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
NA
Tips penanganan yang direkomendasikan
Pastikan parameter, di sini price, terbentuk dengan baik. 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 di
batas yang dipublikasikan. Jika melebihi
nilai minimum ini, Anda akan menerima error ini. Terkadang ada lonjakan traffic yang menyebabkan hal ini, atau server Anda diperluas ke lebih banyak thread.
Tips penanganan yang direkomendasikan
Kurangi total permintaan
yang dikirim per menit. Mengelompokkan beberapa panggilan metode ke layanan yang sama menjadi
satu permintaan custombatch akan menurunkan jumlah permintaan
HTTP yang dibuat.
Tips pencegahan
Saat Anda menerima error ini, gunakan strategi pengelompokan dan
backoff terprogram untuk mengurangi kapasitas permintaan ke tingkat berkelanjutan
yang sesuai.
validasi
[adwords_redirect]
Ringkasan
Mengirimkan produk yang kolom adwords_redirect-nya
bukan URL yang valid.
Mengirimkan merek, deskripsi, atau atribut lainnya
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.
Mengirimkan produk tanpa atribut yang diperlukan/direkomendasikan.
Penyebab umum
NA
Tips penanganan yang direkomendasikan
Pastikan Anda menyertakan
semua atribut yang direkomendasikan / diperlukan 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
Mengirim produk dengan URL dasar yang berbeda
dari URL yang diklaim oleh akun Merchant Center.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-25 UTC."],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],["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"]]
