Content API for Shopping'in resmi olarak yerini alacak olan Merchant API ile tanışın.

Yeni Merchant API özellikleri, hata düzeltmeleri ve güncellemeleri hakkında en güncel bilgileri edinin.

Merchant API'yi kullanmaya başlayın ve veriler, analizler ve benzersiz özelliklere geniş ölçekte erişin.

Not: Content API for Shopping, 18 Ağustos 2026'da kullanımdan kaldırılacak.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Yaygın görülen hatalar

En yaygın hatalar şunlardır:

notFound: Öğe bulunamadı.
not_inserted: Öğe eklenemedi.
[link] validation/invalid_value for <destinations>: URL'ler web sitenize ait değil.
quota/too_many_items: Satıcı kotası aşıldı.

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.

internalError

`Internal error`
Özet	Google arka ucuyla ilgili bir sorun var.
Genel nedenler	Yok
Kullanımla ilgili önerilen ipuçları	İsteği yeniden deneyin. Sürekli başarısız olursa bizimle iletişime geçin.
Korunmayla ilgili ipuçları	Yok

geçersiz

`Invalid channel: '<channel>'`
Özet	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.
`[name] The term '<term>' is not allowed`
Özet	Ad yasaklı bir kelime içeriyor.
Genel nedenler	Yok
Kullanımla ilgili önerilen 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 belirtildi.
Genel nedenler	Yok
Kullanımla ilgili önerilen ipuçları	Para birimi ve ülkenin doğru şekilde belirtildiğinden emin olun. Daha fazla bilgi için Feed Spesifikasyonu Yardım Merkezi makalesinin `price` ile ilgili bölümüne bakın.
Korunmayla ilgili ipuçları	Yok
`[storeCode] storeCode must be 'online'`
Özet	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.
Genel nedenler	Yok
Kullanımla ilgili önerilen 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	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. Bu çözümleri denediyseniz ve Merchant Center hesabınızdaki yeni ürünler için hâlâ alanınız yoksa hesabınızdan daha fazla öğe gönderebilme özelliğini isteyebilirsiniz.
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 sayıda alt hesaba sahipsiniz.
Genel nedenler	Yok
Kullanımla ilgili önerilen ipuçları	Eski alt hesapları silin. Tüm hesaplarınız etkinse MCA'nızda ek alt hesap oluşturabilme özelliğini isteyebilirsiniz.
Korunmayla ilgili ipuçları	Yok
`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.
Korunmayla ilgili ipuçları	Yok
`[item] internal`
Özet	Dahili bir hata.
Genel nedenler	Yok
Kullanımla ilgili önerilen ipuçları	İsteği yeniden deneyin. Sürekli başarısız olursa bizimle iletişime geçin.
Korunmayla ilgili ipuçları	Yok
`[item_group_id] invalid_attribute`
Özet	Varyant özelliği (renk, beden, desen veya malzeme) için hem `itemGroupId` hem de birçok değere sahip bir öğe gönderildi.
Genel nedenler	Öğe grubu kodu belirtirken ürün için birden fazla beden belirtme.
Kullanımla ilgili önerilen ipuçları	Belirli bir varyant özelliğinin her değeri için farklı bir ürün gönderin (ör. `size`).
Korunmayla ilgili ipuçları	Yok
`[additional_image_link] invalid_attribute`
Özet	10'dan fazla ek resim bağlantısı gönderildi.
Genel nedenler	Yok
Kullanımla ilgili önerilen ipuçları	Ek resim bağlantılarının sayısını 10 ile sınırlandırın.
Korunmayla ilgili ipuçları	Yok
`[<attribute>] invalid_character`
Özet	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.
Genel nedenler	Yok
Kullanımla ilgili önerilen 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ı Yardım Merkezi makalesine bakın.
Korunmayla ilgili ipuçları	Yok
`[<attribute>] missing_recommended` / `missing_required`
Özet	Gerekli/önerilen özellik olmadan bir ürün gönderilmiş.
Genel nedenler	Yok
Kullanımla ilgili önerilen ipuçları	Ürününüze önerilen / zorunlu 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 bir ürün gönderilmiş.
Genel nedenler	Yok
Kullanımla ilgili önerilen 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