Aşağıda, alfabetik olarak sıralanmış hataların listesi verilmiştir.
auth/account_access_denied
User cannot access account
<account_number>
Özet
Kimlik doğrulaması yapılmış kullanıcının erişemediği bir hesabı hedefleyen bir istek gönderildi.
Genel nedenler
Hedef satıcı kimliğinde hata veya kullanıcıyı Merchant Center'a kaydettirme
Önerilen kullanım ipuçları
Doğru hesabı hedeflediğinizden emin olun veya Merchant Center'da (Ayarlar > Kullanıcılar) kendinizi hesabın kullanıcısı olarak kaydedin.
Korunmayla ilgili ipuçları
Yok
User is not an administrator of
account <account_number>
Özet
Kimliği doğrulanmış kullanıcının yönetici haklarına sahip olmadığı bir hesapta değişiklik yapılması için istek gönderildi.
Genel nedenler
Yok
Önerilen kullanım ipuçları
Kimliği doğrulanmış kullanıcı için yönetici haklarını ayarlayın.
Korunmayla ilgili ipuçları
Yok
anlaşmazlık
[productId] Product ID <product
id> is already modified by another entry in the same request for merchant
<merchant> and store code <store code>
Özet
Aynı anda birden fazla çakışan işleme girişimde bulunuldu.
Genel nedenler
Tek bir toplu istek, aynı ürün için birbiriyle çelişen birden fazla işlem içeriyor veya aynı ürün için birbiriyle çelişen birden fazla işlem Content API'ye aynı anda gönderildi.
Önerilen kullanım ipuçları
Korunmayla ilgili ipuçlarına bakın.
Korunmayla ilgili ipuçları
Belirli bir ürüne yönelik tüm değişiklikleri, toplu istek grubunda tek bir işlemde içerir. Aynı satıcı ve mağaza kodu için Content API'ye birden fazla eşzamanlı çağrı göndermekten kaçının veya bu çağrıların çakışan ürünler içermediğinden emin olun.
internalError
Internal error
Özet
Google arka ucuyla ilgili bir sorun var.
Genel nedenler
Yok
Önerilen kullanım ipuçları
İsteği yeniden deneyin.
Sürekli başarısız olursa bize ulaşın.
Korunmayla ilgili ipuçları
Yok
geçersiz
Invalid channel:
'<channel>'
Özet
Ürün kimliğinin bir parçası olarak sağlanan kanal geçersiz.
Örneğin: not_a_channel:en:US:sku123.
Genel nedenler
Yok
Önerilen kullanım ipuçları
Yok
Korunmayla ilgili ipuçları
Ürün kimliğinizin channel:languageCode:countryCode:offerId biçiminde olduğundan emin olun. Örneğin:
online:en:US:sku123. Daha fazla bilgi için Products.insert referans dokümanlarına bakın.
[countrycode] Invalid country code:
'<country_code>'
Özet
Ürün kimliğinin bir parçası olarak sağlanan ülke kodu geçersiz.
Örneğin: online:en:not_a_country_code:sku123.
Genel nedenler
Yok
Önerilen kullanım ipuçları
Yok
Korunmayla ilgili ipuçları
Ürün kimliğinizin channel:languageCode:countryCode:offerId biçiminde olduğundan ve ülke kodunun geçerli bir
ISO 3166 ülke kodu olduğundan emin olun.
[item id] Invalid item
id: '<id>'
Özet
Geçersiz öğe kimliği (ör. online:en:US:sku123 yerine sku123.
Genel nedenler
GET veya DELETE isteğinde ürün kimliği yerine teklif kimliği belirtme
Önerilen kullanım ipuçları
Yok
Korunmayla ilgili ipuçları
Ürün kimliğinizin channel:languageCode:countryCode:offerId biçiminde olduğundan emin olun.
Envanter feed'i aracılığıyla bir online ürünün fiyatını ve stok durumunu güncellemeye çalıştı ancak URL'de mağaza kimliği olarak özel değer online yerine başka bir değer belirtti.
Genel nedenler
Yok
Önerilen kullanım ipuçları
İstek URL'sinde mağaza kimliğini online olarak değiştirin.
Korunmayla ilgili ipuçları
Tüm envanter sorgularınızda çevrimiçi ürünler için online
ve yerel ürünler için mağaza kimliğini belirttiğinizden emin olun.
[<attribute>]
Özet
Köşeli parantez içinde belirtilen öğe geçerli değil.
Almaya, güncellemeye veya silmeye çalıştığınız öğe mevcut değil.
Genel nedenler
Var olmayan bir ürünü silmeye çalışmak veya silme URL'sinde ürün kimliğini doğru şekilde belirtmemek.
Önerilen kullanım ipuçları
Products.list kullanarak ürünlerin listesini alın ve yalnızca burada görünen öğeleri almaya, güncellemeye veya silmeye çalışın. Teklif kimliği yerine channel:languageCode:countryCode:offerId biçiminde ürün kimliğini (ör. online:ru:RU:277104-ekb) belirttiğinizden emin olun. Teklif kimliği şu şekilde görünür: 277104-ekb.
Korunmayla ilgili ipuçları
Yok
not_inserted
The item could not be
inserted.
Özet
Mevcut iyi bir girişin üzerine yazılacağı için ürün, diğer hatalar nedeniyle eklenemedi.
Genel nedenler
Yok
Önerilen kullanım ipuçları
Yeni ürün bilgilerini yeniden eklemeden önce aynı aramayla ilgili diğer hataları kontrol edip giderin.
Korunmayla ilgili ipuçları
Yok
kota
too_many_items: Merchant
quota exceeded
Özet
Google Alışveriş'e çok fazla öğe yüklendi.
Genel nedenler
Doğrulanamayan ürünler, mevcut bir geçerli ürünün yerini almıyorsa yine de eklenebilir. Hesabınızda çok sayıda geçersiz ürün bulunmadığından emin olmak için includeInvalidInsertedItems işaretini kullanabilirsinizProductstatuses.list.
Önerilen kullanım ipuçları
Yukarıda belirtildiği gibi çok sayıda geçersiz ürün olup olmadığını kontrol edip kaldırın. Ayrıca, ürünleri yüklerken
geçerlilik bitiş tarihlerini belirtin. Süre dolduktan sonra ürün otomatik olarak silinir. Varsayılan ve maksimum geçerlilik bitiş tarihinin, ürün ekleme veya güncelleme işleminden 30 gün sonra olduğunu unutmayın.
Not: Çok müşterili bir hesabın öğe kotası, tüm alt hesaplardaki toplam ürün sayısına göre kontrol edilir. Bu hatayı bir alt hesapla alırsanız hem alt hesabın hem de MCA'nızın yeterli ürün kotasına sahip olduğundan emin olun.
request_rate_too_high:
Request rate too high. Please reduce your throughput
Özet
İstekler çok hızlı gönderiliyor. İstek sıklığını azaltın.
Genel nedenler
Yayınlanan sınırlar bölümünde listelenen dakika başına kotalara bakın. Bu eşikleri aşarsanız bu hatayı alırsınız. Bazen trafikte bu duruma neden olan ani bir artış olur veya sunucunuz daha fazla sayıda iş parçacığına genişler.
Önerilen kullanım ipuçları
Bir dakikada gönderilen toplam isteği azaltın.
Korunmayla ilgili ipuçları
Bu hatayı aldığınızda, istek hızınızı uygun bir sürdürülebilir seviyeye düşürmek için programatik geri çekilme stratejilerini kullanın.
daily_limit_exceeded:
merchant quota exceeded
Özet
Belirtilen hizmet yöntemi için günde izin verilenden daha fazla istek gönderiyorsunuz.
Genel nedenler
Yayınlanan sınırlar bölümünde listelenen günlük kotalara bakın. Bu eşikleri aşarsanız bu hatayı alırsınız.
Önerilen kullanım ipuçları
Mümkün olduğunda birden fazla değişikliği tek bir istekle birleştirerek günlük gönderilen toplam isteği azaltın. Bir ürünün hızlı bir şekilde birden çok kez değiştirilmesini önlemek için ürünlerdeki değişiklikleri uygun bir dönemde toplu olarak yapmayı düşünebilirsiniz. Web sitenizde mikro veri olarak temsil edilebilecek öğe güncellemeleri için Products veya Inventory hizmetlerine yapılan çağrı sayısını sınırlandırmak amacıyla bu yaklaşımı kullanmayı düşünebilirsiniz.
Belirli bir yöntem için günlük daha fazla çağrıya ihtiyacınız varsa lütfen bize ulaşın ve Merchant Center kimliğinizi, kota sınırlarını hangi yöntemlerde aştığınızı, bu yöntemler için günlük kaç çağrıya ihtiyacınız olduğunu ve nedenini bize bildirin. Kotanızın artırılması için sizinle birlikte çalışacağız.
Korunmayla ilgili ipuçları
Önerilen kullanım ipuçlarına göz atın.
too_many_failed_auths:
Too many failed authentications.
Özet
Erişiminiz olmayan hesaplar için çok fazla toplu istek gönderiyorsunuz.
Genel nedenler
Silinen alt hesaplar veya yeni oluşturulan alt hesaplar için henüz kullanıma sunulmadan önce toplu istek gönderme
Önerilen kullanım ipuçları
Silinen bir alt hesabı etkileyen aramalar yapmaktan kaçının.
Korunmayla ilgili ipuçları
Önerilen kullanım ipuçlarına göz atın.
request_too_large
Özet
Toplu istek başına çok fazla entries gönderiyorsunuz veya custombatch istek boyutu sınırını aşıyorsunuz.
Genel nedenler
custombatch isteği başına en fazla 10.000 entries ekleyebilirsiniz. Sıkıştırılmış aktarım boyutu sınırı 32 MB'tır.
Önerilen kullanım ipuçları
Grubu sınırın altındaki birden fazla gruba ayırıp tekrar deneyin.
Korunmayla ilgili ipuçları
Grup başına en fazla 1.000 giriş göndermenizi öneririz.
zorunlu
[price.value] Required parameter: price.value
Özet
Değer olmadan bir fiyat belirtildi. Örneğin:
{ "value": 123, "currency": "USD" } yerine
{ "currency": "USD" }.
Genel nedenler
Yok
Önerilen kullanım ipuçları
Buradaki price parametresinin düzgün biçimlendirildiğinden emin olun. Örneğin,
price iki zorunlu alana sahiptir: value ve
currency.
Korunmayla ilgili ipuçları
Yok
[product] INSERT request must specify
product
Özet
API'ye "method": "insert" içeren ancak ürün içermeyen bir girişin yer aldığı özel bir toplu istek gönderildi.
Genel nedenler
Yöntemi get veya delete olarak değiştirmeyi unutan kullanıcılar
Önerilen kullanım ipuçları
product alanı aracılığıyla eklenecek bir ürün belirtin.
Korunmayla ilgili ipuçları
insert yöntemine sahip toplu girişlerde bir ürünün, get veya delete yöntemine sahip toplu girişlerde ise bir ürün kimliğinin belirtildiğinden emin olun.
[productId] DELETE request must specify
productId
Özet
API'ye "method": "delete" içeren ancak ürün kimliği olmayan bir girişin yer aldığı özel bir toplu istek gönderildi.
Genel nedenler
Yöntemi insert olarak değiştirmeyi unutan kullanıcılar
Önerilen kullanım ipuçları
productID alanı aracılığıyla silinecek bir ürün belirtin.
Korunmayla ilgili ipuçları
insert yöntemine sahip toplu girişlerde bir ürünün, get veya delete yöntemine sahip toplu girişlerde ise bir ürün kimliğinin belirtildiğinden emin olun.
userRateLimitExceeded
User Rate Limit
Exceeded
Özet
İstekler çok hızlı gönderiliyor. İstek sıklığını azaltın.
Genel nedenler
Yayınlanan sınırlar bölümünde listelenen HTTP istek sınırlarına bakın. Bu eşikleri aşarsanız bu hatayı alırsınız. Bazen trafikte bu duruma neden olan ani bir artış olur veya sunucunuz daha fazla sayıda iş parçacığına genişler.
Önerilen kullanım ipuçları
Bir dakikada gönderilen toplam isteği azaltın. Aynı hizmete yapılan birden fazla yöntem çağrısını tek bir custombatch isteğinde toplamak, yapılan HTTP isteklerinin sayısını azaltır.
Korunmayla ilgili ipuçları
Bu hatayı aldığınızda, istek hızınızı uygun ve sürdürülebilir bir seviyeye düşürmek için gruplandırma ve programatik geri çekilme stratejilerini kullanın.
doğrulama
[adwords_redirect]
Özet
adwords_redirect alanının geçerli bir URL olmadığı bir ürün gönderildi.
Genel nedenler
Yok
Önerilen kullanım ipuçları
adwords_redirect alanının değerinin geçerli bir URL olduğundan emin olun.
Korunmayla ilgili ipuçları
Yok
[item] auth/frontend/not_claimed
Özet
Satıcının web sitesi URL'si için Merchant Center'da hak talebinde bulunulmamış.
Genel nedenler
Yok
Önerilen kullanım ipuçları
Merchant Center'da URL için hak talebinde bulunun. Bu işlemin ayrıntılı prosedürüne Yardım Merkezi'nden ulaşabilirsiniz.
Marka, açıklama veya başka bir özelliği, belirtilen istek kodlaması kullanılarak ayrıştırılmayan bir dize olarak gönderme
Genel nedenler
Yok
Önerilen kullanım ipuçları
Sorunun hangi özelliğe bağlı olduğunu öğrenmek için mesajı kontrol edin, ardından yeniden göndermeden önce ilgili değerin metin kodlamasını doğrulayın. API yalnızca geçerli UTF-8 karakterlerini kabul eder.
Korunmayla ilgili ipuçları
Yok
[<attribute>] invalid_value
Özet
Geçerli olmayan bir renk, açıklama veya başka bir özellik gönderildi.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-06-19 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"]]
