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

Content API for Shopping'in resmi halefi olan Merchant API ile tanışın.

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

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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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ı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