Aşağıda, alfabetik sırayla bir hata listesi verilmiştir.
kimlik doğrulama/hesap erişimi reddedildi
User cannot access account
<account_number>
Özet
Kimliği doğrulanan kullanıcının erişiminin olmadığı bir hesabı hedefleyen istek gönderildi.
Genel nedenler
Hedef satıcı kimliğinde hata oluştu veya kullanıcının Merchant Center'a kaydedilmesi unutuldu.
Kullanımla ilgili önerilen ipuçları
Merchant Center'da (Ayarlar > Kullanıcılar) doğru hesabı hedeflediğinizden emin olun veya 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ğrulanan kullanıcının yönetici haklarına sahip olmadığı bir hesabın değiştirilmesi için istek gönderildi.
Genel nedenler
Yok
Kullanımla ilgili önerilen 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şlem denendi.
Genel nedenler
Tek bir toplu istek, aynı ürün için birden fazla çakışan işlem içeriyor veya aynı ürün üzerinde çakışan birden çok işlem Content API'ye aynı anda gönderildi.
Kullanımla ilgili önerilen ipuçları
Korunmayla ilgili ipuçlarına bakın.
Korunmayla ilgili ipuçları
Belirli bir ürünün, toplu istek kümesindeki tek bir işlemle ilgili tüm değişiklikleri içerir. Aynı satıcı ve mağaza kodu için Content API'ye birden fazla eşzamanlı çağrıdan kaçınmaya çalışın veya bu çağrıların çakışan ürünler içermediğinden emin olun.
Bir ürün kimliğinin parçası olarak geçersiz kanal sağlandı.
Örneğin: not_a_channel:en:US:sku123.
Genel nedenler
Yok
Kullanımla ilgili önerilen 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 ile ilgili referans belgeleri inceleyin.
[countrycode] Invalid country code:
'<country_code>'
Özet
Ürün kimliğinin parçası olarak geçersiz ülke kodu sağlandı.
Örneğin: online:en:not_a_country_code:sku123.
Genel nedenler
Yok
Kullanımla ilgili önerilen ipuçları
Yok
Korunmayla ilgili ipuçları
Ürün kimliğinizin channel:languageCode:countryCode:offerId biçiminde 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.
Kullanımla ilgili önerilen 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 ve stok durumu bilgilerini güncellemeye çalışıldı ancak URL'de mağaza kimliği olarak online özel değerinden başka bir değer belirtildi.
Genel nedenler
Yok
Kullanımla ilgili önerilen ipuçları
İstek URL'sinde mağaza kimliğini online olarak değiştirin.
Korunmayla ilgili ipuçları
Online ürünler için online değerini ve tüm envanter sorgularınızda 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 ya da ürün kimliğini silinmek üzere URL'de doğru şekilde belirtmemek.
Kullanımla ilgili önerilen ipuçları
Products.list kullanarak ürünlerin listesini alın ve yalnızca orada görünen öğeleri almaya, güncellemeye veya silmeye çalışın. Ürün kimliğini channel:languageCode:countryCode:offerId biçiminde belirttiğinizden emin olun. Örneğin, teklif kimliği yerine online:ru:RU:277104-ekb. Şu şekilde görünür: 277104-ekb.
Korunmayla ilgili ipuçları
Yok
not_inserted
The item could not be
inserted.
Özet
Diğer hatalar nedeniyle ürün, mevcut iyi bir girişin üzerine yazacağı için eklenemedi.
Genel nedenler
Yok
Kullanımla ilgili önerilen ipuçları
Aynı çağrıyla ilgili diğer hataları kontrol edin ve yeni ürün bilgilerini yeniden eklemeyi denemeden önce bunları 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 ve geçerli bir ürünün yerine geçmezlerse yine de eklenebilir. Hesabınızda çok fazla sayıda geçersiz ürün bulunmadığından emin olmak için Productstatuses.list için includeInvalidInsertedItems işaretini kullanabilirsiniz.
Kullanımla ilgili önerilen ipuçları
Yukarıda belirtildiği gibi çok fazla sayıda geçersiz ürün olup olmadığını kontrol edin ve bunları kaldırın. Ayrıca, ürünleri yüklerken
son kullanma tarihleri belirtin. Geçerlilik bitiş tarihine ulaşıldığında ürün otomatik olarak silinir. Varsayılan ve maksimum son kullanma tarihinin, ürün eklendikten veya güncellendikten 30 gün sonra olduğunu unutmayın.
Not: Çok müşterili hesapların öğe kotası, tüm alt hesaplardaki toplam ürün sayısına göre kontrol edilir. Bu hatayı bir alt hesapta 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ı yapılıyor. Bu nedenle istek sıklığını azaltın.
Genel nedenler
Yayınlanan sınırlarda listelenen dakika başına kotalara bakın. Bu eşikleri aşarsanız bu hatayı alırsınız. Bazen trafikte ani bir artışa neden olur veya sunucunuz daha fazla sayıda iş parçacığı içerecek şekilde genişler.
Kullanımla ilgili önerilen ipuçları
Dakika başına gönderilen toplam istek sayısını azaltın.
Korunmayla ilgili ipuçları
Bu hatayı aldığınızda, istek oranınızı uygun bir sürdürülebilir düzeye indirmek için programatik geri çekme stratejilerini kullanın.
daily_limit_exceeded:
merchant quota exceeded
Özet
Belirli bir hizmet yöntemi için izin verilen günlük istek sayısından daha fazla istek yapıyorsunuz.
Genel nedenler
Yayınlanan sınırlarda listelenen günlük kotalara bakın. Bu eşikleri aşarsanız bu hatayı alırsınız.
Kullanımla ilgili önerilen ipuçları
Mümkün olduğunda birden fazla değişikliği tek bir istekte birleştirerek gün başına gönderilen toplam istek sayısını azaltın. Bir ürünün birkaç kez hızlıca değiştirilmesini önlemek için ürünlerde toplu değişiklikleri uygun bir süre boyunca yapabilirsiniz. Web sitenizde mikro veri olarak temsil edilebilecek öğe güncellemelerinde, Products veya Inventory hizmetlerine yapılan çağrı sayısını sınırlamak amacıyla bu yaklaşımı kullanabilirsiniz.
Belirli bir yöntem için hâlâ günlük daha fazla çağrıya ihtiyacınız varsa lütfen bizimle iletişime geçin ve kota sınırlarına ulaştığınız yöntemleri, bu yöntemler için günde kaç çağrıya ihtiyaç duyacağınıza ve neden ihtiyaç duyduğunuza dair tahmini bir tahmini olarak Merchant Center kimliğinizi bize bildirin. Kotanızı yükseltmeniz için sizinle birlikte çalışırız.
Korunmayla ilgili ipuçları
Önerilen kullanım ipuçları bölümüne bakın.
too_many_failed_auths:
Too many failed authentications.
Özet
Erişiminiz olmayan hesaplar için çok fazla toplu istek yapıyorsunuz.
Genel nedenler
Silinmiş alt hesaplar veya kullanıma sunulmadan önce yeni oluşturulan alt hesaplar için toplu olarak istekte bulunma.
Kullanımla ilgili önerilen ipuçları
Silinmiş bir alt hesabı etkileyen çağrılar yapmaktan kaçının.
Korunmayla ilgili ipuçları
Önerilen kullanım ipuçları bölümüne bakın.
request_too_large
Özet
Toplu istek başına çok fazla entries 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ı ise 32 MB'tır.
Kullanımla ilgili önerilen ipuçları
Grubu, sınırların altında olan birden fazla gruba bölüp tekrar deneyin.
Korunmayla ilgili ipuçları
Grup başına 1.000'den fazla giriş göndermemenizi öneririz.
zorunlu
[price.value] Required parameter: price.value
Özet
Değer içermeyen bir fiyat belirtilmiş. Örneğin: { "value": 123, "currency": "USD" } yerine { "currency": "USD" }.
Genel nedenler
Yok
Kullanımla ilgili önerilen ipuçları
Buradaki price parametresinin doğru şekilde 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 bir giriş içeren ancak ürün içermeyen özel bir toplu istek gönderildi.
Genel nedenler
Yöntemi get veya delete olarak değiştirmeyi unutuyorsunuz.
Kullanımla ilgili önerilen ipuçları
product alanı aracılığıyla eklenecek ürünü belirtin.
Korunmayla ilgili ipuçları
insert yöntemini kullanan toplu girişlerin bir ürün belirttiğinden ve
get veya delete yöntemini kullanan toplu girişlerin bir ürün kimliği belirttiğinden emin olun.
[productId] DELETE request must specify
productId
Özet
API'ye "method": "delete" içeren ancak ürün kimliği olmayan bir giriş içeren özel bir toplu istek gönderildi.
Genel nedenler
Yöntemi insert olarak değiştirmeyi unutuyorsunuz.
Kullanımla ilgili önerilen ipuçları
productID alanı aracılığıyla silinecek ürünü belirtin.
Korunmayla ilgili ipuçları
insert yöntemini kullanan toplu girişlerin bir ürün belirttiğinden ve
get veya delete yöntemini kullanan toplu girişlerin bir ürün kimliği belirttiğinden emin olun.
userRateLimitExceeded
User Rate Limit
Exceeded
Özet
İstekler çok hızlı yapılıyor. Bu nedenle istek sıklığını azaltın.
Genel nedenler
Yayınlanan sınırlarda listelenen HTTP istek sınırlarına bakın. Bu eşikleri aşarsanız bu hatayı alırsınız. Bazen trafikte ani bir artışa neden olur veya sunucunuz daha fazla sayıda ileti dizisine genişler.
Kullanımla ilgili önerilen ipuçları
Dakika başına gönderilen toplam istek sayısını azaltın. Aynı hizmete yapılan birden fazla yöntem çağrısının tek bir custombatch isteğinde toplanması, yapılan HTTP isteklerinin sayısını azaltır.
Korunmayla ilgili ipuçları
Bu hatayı aldığınızda, istek oranınızı uygun bir sürdürülebilir düzeye indirmek için toplu işleme ve programatik geri gönderme stratejilerini kullanın.
validation
[adwords_redirect]
Özet
adwords_redirect alanı geçerli bir URL olmayan bir ürün gönderilmiş.
Genel nedenler
Yok
Kullanımla ilgili önerilen ipuçları
adwords_redirect alanındaki değerin 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 bulunulmadı.
Genel nedenler
Yok
Kullanımla ilgili önerilen ipuçları
Merchant Center'da URL ile ilgili hak talebinde bulunun. Bununla ilgili ayrıntılı prosedür, Yardım Merkezi'nde bulunmaktadır.
Korunmayla ilgili ipuçları
Yok
[energy_efficiency_class]
validation/feed
Özet
Aynı ürün için hem energyEfficiencyClass hem de
birim fiyatlandırma belirtilmiş.
Genel nedenler
Yok
Kullanımla ilgili önerilen ipuçları
Yalnızca enerji verimlilik sınıfını veya birim fiyatlandırmasını belirtin, ikisini birden değil.
Marka, açıklama veya başka bir özellik, belirtilen istek kodlamasıyla ayrıştırılmayan bir dize olarak gönderilmiş.
Genel nedenler
Yok
Kullanımla ilgili önerilen ipuçları
Soruna hangi özelliğin neden 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.
[null,null,["Son güncelleme tarihi: 2024-07-03 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"]]