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.
auth/account_access_denied
User cannot access account
<account_number> |
|
|---|---|
| Ringkasan | Memberikan 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 daftarkan diri Anda sebagai pengguna akun di Merchant Center (Setelan > Pengguna). |
| Tips pencegahan | TA |
User is not an administrator of
account <account_number> |
|
| Ringkasan | Memunculkan permintaan untuk mengubah akun yang hak adminnya tidak dimiliki oleh pengguna terautentikasi. |
| 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 | Permintaan batch tunggal berisi beberapa operasi yang bertentangan untuk produk yang sama, atau beberapa operasi yang bertentangan ke produk yang sama dikirimkan ke Content API secara bersamaan. |
| Tips penanganan yang direkomendasikan | Lihat tips pencegahan. |
| Tips pencegahan | Berisi semua perubahan untuk produk tertentu terhadap satu operasi dalam kumpulan permintaan. 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 | TA |
| Tips penanganan yang direkomendasikan | Coba lagi permintaan tersebut. Beri tahu kami di forum jika gagal terus-menerus. |
| Tips pencegahan | TA |
nggak valid
Invalid channel:
'<channel>' |
|
|---|---|
| Ringkasan | Saluran yang disediakan 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 berupa
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 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 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 | TA |
| Tips pencegahan | Pastikan ID produk Anda berformat
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 mengetahui informasi selengkapnya. |
| Tips pencegahan | TA |
[price.currency] Please use a currency
that is supported in the target country |
|
| Ringkasan | Menetapkan mata uang yang tidak tersedia di negara target. |
| Penyebab umum | TA |
| Tips penanganan yang direkomendasikan | Pastikan mata uang dan negara ditentukan dengan benar. Lihat bagian price di artikel Pusat Bantuan Spesifikasi Feed untuk mengetahui informasi selengkapnya. |
| Tips pencegahan | TA |
[storeCode] storeCode must be
'online' |
|
| Ringkasan | Mencoba memperbarui harga dan ketersediaan
produk online melalui feed inventaris, tetapi menentukan hal 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 Anda. |
[<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 mengetahui informasi selengkapnya. |
| 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 untuk mendapatkan, memperbarui, atau menghapus
item yang muncul di sana. Pastikan Anda menentukan ID produk dalam format
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 lain, produk tidak dapat dimasukkan karena akan menimpa entri barang yang sudah ada. |
| Penyebab umum | TA |
| Tips penanganan yang direkomendasikan | Periksa error lain untuk panggilan yang sama dan atasi 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 masih dapat dimasukkan, jika tidak menggantikan produk valid yang sudah ada. Sebaiknya gunakan
flag
includeInvalidInsertedItems ke
Productstatuses.list untuk memastikan akun Anda tidak memiliki
produk yang tidak valid dalam jumlah yang berlebihan. |
| Tips penanganan yang direkomendasikan | Periksa, dan hapus, terlalu banyak produk tidak valid 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 akan dibandingkan dengan jumlah total produk di semua sub-akun. Jika Anda mendapatkan error ini di 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 maksimum sub-akun 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 melebihi batas 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 back-off terprogram untuk mengurangi rasio permintaan ke tingkat berkelanjutan yang sesuai. |
daily_limit_exceeded:
merchant quota exceeded |
|
| Ringkasan | Anda membuat lebih dari jumlah permintaan per hari yang diizinkan untuk metode layanan yang ditentukan. |
| Penyebab umum | Lihat kuota per hari yang tercantum di batas yang dipublikasikan. Jika melebihi batas 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 tepat agar produk tidak cepat berubah beberapa kali. Untuk pembaruan
item yang dapat ditampilkan sebagai
microdata
di situs Anda, pertimbangkan untuk menggunakan pendekatan tersebut guna membatasi jumlah panggilan
ke layanan Jika Anda masih memerlukan lebih banyak panggilan harian untuk metode tertentu, hubungi kami dan beri tahu kami tentang ID Merchant Center Anda, metode mana yang mencapai batas kuota, perkiraan jumlah panggilan per hari yang diperlukan untuk metode tersebut beserta 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 tidak Anda miliki aksesnya. |
| Penyebab umum | Membuat permintaan dalam beberapa 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 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 kirim tidak lebih dari 1.000 entri per batch. |
wajib
[price.value] Required parameter: price.value |
|
|---|---|
| Ringkasan | Menetapkan harga tanpa nilai. Contoh:
{ "currency": "USD" }, bukan
{ "value": 123, "currency": "USD" }. |
| Penyebab umum | TA |
| Tips penanganan yang direkomendasikan | Pastikan
parameter, di sini
price, diformat dengan baik. 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 tanpa 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 di batas yang dipublikasikan. Jika melebihi batas 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 dibuat. |
| Tips pencegahan | Saat Anda menerima error ini, gunakan strategi back-off terprogram dan pengelompokan untuk mengurangi rasio permintaan ke tingkat berkelanjutan yang sesuai. |
validasi
[adwords_redirect] |
|
|---|---|
| Ringkasan | Mengirim produk yang kolom adwords_redirect
bukan URL yang valid. |
| Penyebab umum | TA |
| Tips penanganan yang direkomendasikan | Pastikan nilai
kolom
adwords_redirect adalah 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 | Menetapkan 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. Beri tahu kami di forum jika gagal terus-menerus. |
| Tips pencegahan | TA |
[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 sebuah produk saat menentukan ID kelompok item. |
| Tips penanganan yang direkomendasikan | Kirimkan produk
berbeda untuk setiap nilai atribut varian tertentu, seperti
size. |
| Tips pencegahan | TA |
[additional_image_link]
invalid_attribute |
|
| Ringkasan | Mengirim 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 | Mengirimkan 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 mencari tahu atribut mana yang menyebabkan masalah, lalu validasikan encoding teks dari nilai yang sesuai sebelum mengirim ulang. API ini 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 | Pastikan semua atribut mematuhi spesifikasi feed. Baca artikel Pusat Bantuan Spesifikasi Feed untuk mengetahui informasi selengkapnya. Untuk masalah GTIN atau MPN, baca artikel Pusat Bantuan Kode Unik produk. |
| Tips pencegahan | TA |
[<attribute>]
missing_recommended / missing_required |
|
| Ringkasan | Mengirimkan produk tanpa atribut wajib/direkomendasikan. |
| Penyebab umum | TA |
| Tips penanganan yang direkomendasikan | Pastikan Anda menyertakan semua atribut yang direkomendasikan / diperlukan untuk produk Anda. Baca artikel Pusat Bantuan Spesifikasi Feed untuk mengetahui 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 |