add_alert
Önemli: Content API for Shopping'in desteği 18 Ağustos 2026'da sonlandırılacak.
rocket
Content API for Shopping'in resmi halefi olan
Merchant API ile tanışın.
Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.
Yaygın görülen hatalar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
En yaygın hatalar şunlardır:
Aşağıda, alfabetik sıraya göre hata listesi verilmiştir.
auth/account_access_denied
User cannot access account
<account_number> |
|---|
| Özet | Kimliği doğrulanmış kullanıcının erişimi olmayan bir hesabı hedefleyen istek gönderildi. |
| Genel nedenler | Hedef satıcı kimliğinde hata var veya kullanıcıyı Merchant Center'a kaydetmeyi unuttunuz. |
| Ö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ının olmadığı bir hesapta değişiklik yapma isteğinde bulunuldu. |
| 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şlem denenmiştir. |
| Genel nedenler | Tek bir toplu istek, aynı ürün için birden fazla çakışan işlem içeriyor veya aynı ürüne yönelik birden fazla çakışan işlem, aynı anda Content API'ye gönderildi. |
| Önerilen kullanım ipuçları | Korunmayla ilgili ipuçlarına göz atın. |
| Korunmayla ilgili ipuçları | Belirli bir ürüne ait tüm değişiklikleri, toplu istekler kümesindeki tek bir işlemde içerir. Aynı satıcı ve mağaza kodu için Content API'ye aynı anda birden fazla çağrı göndermemeye çalışı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 olarak 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 geçersiz kanal sağlanmış.
Ö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 ile ilgili referans belgelerine 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 belirtilmesi. |
| Önerilen kullanım ipuçları | Yok |
| Korunmayla ilgili ipuçları | Ürün kimliğinizin channel:languageCode:countryCode:offerId biçiminde olduğundan emin olun. |
[name] The term '<term>' is not
allowed |
|---|
| Özet | Ad, yasaklanmış bir kelime içeriyor. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | İzin verilen bir ad kullanın.
Daha fazla bilgi için Feed Spesifikasyonu Yardım Merkezi makalesini inceleyin. |
| Korunmayla ilgili ipuçları | Yok |
[price.currency] Please use a currency
that is supported in the target country |
|---|
| Özet | Hedef ülkede kullanılamayan bir para birimi belirtilmiş. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Para birimi
ve ülkenin doğru şekilde belirtildiğinden emin olun. Daha fazla bilgi için Feed Spesifikasyonu Yardım Merkezi makalesindeki price ile ilgili bölüme bakın. |
| Korunmayla ilgili ipuçları | Yok |
[storeCode] storeCode must be
'online' |
|---|
| Özet | Envanter feed'i aracılığıyla online bir ürünün fiyatını ve stok durumunu güncellemeye çalıştınız ancak URL'deki mağaza kimliği olarak özel değer online dışında bir değer belirttiniz. |
| 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 online ürünler için online, yerel ürünler için ise mağaza kimliğini belirttiğinizden emin olun. |
[<attribute>] |
|---|
| Özet | Köşeli parantez içinde belirtilen öğe geçerli değil. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Sorunlu öğenin spesifikasyonunu düzeltin. Daha fazla bilgi için Feed Spesifikasyonu Yardım Merkezi makalesini inceleyin. |
| Korunmayla ilgili ipuçları | Yok |
notFound
Item not found |
|---|
| Özet | Almaya, güncellemeye veya silmeye çalıştığınız öğe mevcut değil. |
| Genel nedenler | Mevcut 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ün listesi 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, online:ru:RU:277104-ekb biçiminde belirtin. Teklif kimliği ise 277104-ekb biçimindedir. |
| Korunmayla ilgili ipuçları | Yok |
not_inserted
The item could not be
inserted. |
|---|
| Özet | Diğer hatalar nedeniyle ürün, mevcut iyi bir girişi üzerine yazacağından eklenemedi. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Aynı çağrıyla ilgili diğer hataları kontrol edin ve yeni ürün bilgilerini yeniden eklemeyi denemeden önce bu hataları düzeltin. |
| 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 geçerli bir ürünün yerine geçmedikleri sürece yine de eklenebilir. Hesabınızda çok sayıda geçersiz ürün olmadığından emin olmak için includeInvalidInsertedItems işaretini kullanabilirsiniz.
Productstatuses.list |
| Önerilen kullanım ipuçları | Yukarıda belirtildiği gibi, çok sayıda geçersiz ürün olup olmadığını kontrol edin ve varsa bunları kaldırın. Ayrıca, ürünleri yüklerken
geçerlilik bitiş tarihleri belirtin. Geçerlilik bitiş tarihine ulaşıldığında ü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 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.
Bu çözümleri denemenize rağmen Merchant Center hesabınızda yeni ürünler için yer kalmadıysa
hesabınızda daha fazla öğe gönderme isteğinde bulunabilirsiniz. |
| Korunmayla ilgili ipuçları | Önerilen kullanım ipuçları bölümüne bakın. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|---|
| Özet | Çok müşterili hesabınız için izin verilen maksimum alt hesap sayısına ulaştınız. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Eski alt hesapları silin.
Tüm hesaplarınız aktifse
MCA'nızda ek alt hesap oluşturma özelliği isteğinde bulunabilirsiniz. |
| Korunmayla ilgili ipuçları | Yok |
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ırlarda listelenen dakika başına kotalara bakın. Bu eşikleri aşarsanız bu hatayı alırsınız. Buna bazen trafikteki ani artış veya sunucunuzun daha fazla iş parçacığına genişlemesi neden olur. |
| Önerilen kullanım ipuçları | Dakikada gönderilen toplam istek sayısını azaltın. |
| Korunmayla ilgili ipuçları | Bu hatayı aldığınızda, istek sıklığınızı uygun ve sürdürülebilir bir düzeye düşürmek için programatik geri çekilme stratejilerini kullanın. |
daily_limit_exceeded:
merchant quota exceeded |
|---|
| Özet | Belirli bir hizmet yöntemi için günde izin verilen istek sayısından daha fazla istekte bulunuyorsunuz. |
| 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. |
| Önerilen kullanım ipuçları | Mümkün olduğunda birden fazla değişikliği tek bir istekte birleştirerek günlük gönderilen toplam istek sayısını azaltın. Bir ürünü birden çok kez hızlı bir şekilde değiştirmemek için ürünlerdeki değişiklikleri uygun bir süre içinde gruplandırın. Web sitenizde mikro veri olarak gösterilebilen öğe güncellemeleri için Products veya Inventory hizmetlerine yapılan çağrı sayısını sınırlamak üzere bu yaklaşımı kullanabilirsiniz.
Belirli bir yönteme günlük olarak daha fazla çağrı yapmanız gerekiyorsa lütfen bize ulaşın ve Merchant Center kimliğinizi, hangi yöntemlerde kota sınırlarına ulaş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ı 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 gönderiyorsunuz. |
| Genel nedenler | Silinen alt hesaplar veya yeni oluşturulan alt hesaplar için 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ı bölümüne bakı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ı | Toplu işlemi sınırlardan daha küçük birden fazla toplu işleme 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ğeri olmayan bir fiyat belirtildi. Örneğin:
{ "value": 123, "currency": "USD" } yerine
{ "currency": "USD" }. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Buradaki
parametresinin, yani
price, düzgün biçimlendirildiğinden emin olun. Örneğin, price etiketinde iki zorunlu alan vardır: 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ş içeren özel toplu istek gönderildi. |
| Genel nedenler | Yöntemi get
veya delete olarak değiştirmeyi unutma. |
| Önerilen kullanım ipuçları | product alanını kullanarak eklenecek bir ürün belirtin. |
| Korunmayla ilgili ipuçları | Yöntem
insert ile gönderilen toplu girişlerin bir ürün, yöntem get
veya
delete ile gönderilen toplu girişlerin ise 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 içermeyen bir giriş içeren özel bir toplu istek gönderildi. |
| Genel nedenler | Yöntemi insert olarak değiştirmeyi unutma. |
| Önerilen kullanım ipuçları | productID alanı aracılığıyla silinecek bir ürün belirtin. |
| Korunmayla ilgili ipuçları | Yöntem
insert ile gönderilen toplu girişlerin bir ürün, yöntem get
veya
delete ile gönderilen toplu girişlerin ise bir ürün kimliği belirttiğ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. Buna bazen trafikteki ani artış veya sunucunuzun daha fazla iş parçacığına genişlemesi neden olur. |
| Önerilen kullanım ipuçları | Dakikada gönderilen toplam istek sayısını 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 sıklığınızı uygun ve sürdürülebilir bir düzeye düşürmek için toplu işleme ve programatik geri çekilme stratejilerini kullanın. |
doğrulama
[adwords_redirect] |
|---|
| Özet | adwords_redirect alanı geçerli bir URL olmayan bir ürün gönderdiniz. |
| 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 Merchant Center'da hak talebinde bulunulmadı. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | URL ile ilgili hak talebinde bulunmak için Merchant Center'ı kullanın. Bu işlemi yapmayla ilgili ayrıntılı prosedürü Yardım Merkezi'nde bulabilirsiniz. |
| 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 |
| Önerilen kullanım ipuçları | Yalnızca enerji verimlilik sınıfını veya birim fiyatlandırmayı belirtin, her ikisini birden belirtmeyin. |
| Korunmayla ilgili ipuçları | Yok |
[item] internal |
|---|
| Özet | Dahili bir hata. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | İsteği yeniden deneyin.
Sürekli olarak başarısız olursa bize ulaşın. |
| Korunmayla ilgili ipuçları | Yok |
[item_group_id] invalid_attribute |
|---|
| Özet | Hem itemGroupId hem de bir varyant özelliği (renk, beden, desen veya malzeme) için birçok değer içeren bir öğe gönderdiniz. |
| Genel nedenler | Öğe grubu kodu belirtirken bir ürün için birden fazla boyut belirtme. |
| Önerilen kullanım ipuçları |
size gibi belirli bir varyant özelliğinin her değeri için farklı bir ürün gönderin. |
| Korunmayla ilgili ipuçları | Yok |
[additional_image_link]
invalid_attribute |
|---|
| Özet | 10'dan fazla ek resim bağlantısı gönderildi. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları |
Ek resim bağlantılarının sayısını 10 ile sınırlayın. |
| Korunmayla ilgili ipuçları | Yok |
[<attribute>] invalid_character |
|---|
| Özet | Belirtilen istek kodlaması kullanılarak ayrıştırılmayan bir dize olarak marka, açıklama veya başka bir öznitelik gönderildi. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Hangi özelliğin soruna 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önderdiniz. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Tüm özelliklerin feed spesifikasyonuna uygun olduğundan emin olun. Daha fazla bilgi için Feed Spesifikasyonu Yardım Merkezi makalesini inceleyin. GTIN veya MPN sorunları için
Benzersiz ürün tanımlayıcıları ile ilgili Yardım Merkezi makalesine bakın. |
| Korunmayla ilgili ipuçları | Yok |
[<attribute>]
missing_recommended/missing_required |
|---|
| Özet | Gerekli/önerilen bir özellik olmadan ürün gönderildi. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Ürününüz için önerilen / gerekli tüm özellikleri eklediğinizden emin olun. Daha fazla bilgi için Feed
Spesifikasyonu Yardım Merkezi makalesini inceleyin. |
| Korunmayla ilgili ipuçları | Yok |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|---|
| Özet | Merchant Center hesabı tarafından hak talebinde bulunulan URL'den farklı bir temel URL'ye sahip ürün gönderildi. |
| Genel nedenler | Yok |
| Önerilen kullanım ipuçları | Gönderilen ürünlerin URL'lerinin, Merchant Center tarafından hak talebinde bulunulan web sitesiyle eşleştiğinden emin olun. |
| Korunmayla ilgili ipuçları | Yok |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2026-07-06 UTC.
[null,null,["Son güncelleme tarihi: 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"]]