Bu sayfada, Merchant API ile ilgili bilinen geliştirici sorunları açıklanmaktadır.
Ürün ve envanter insert yöntemleri için işleme hızı sorunları
Bildirim tarihi: 28 Ocak 2026 UTC | Son güncelleme: 31 Mart 2026 UTC
Merchant API'ye büyük miktarda veri aktarılırken işleme kapasitesiyle ilgili istemci tarafı performans sorunları yaşandığına dair raporlar aldık. Aşağıdaki yöntemler için istemci kitaplıklarını kullanırken bu sorunla karşılaşabilirsiniz:
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
Çeşitli arka uç sistemlerinin performansını artırmak için iyileştirmeler yaptık. Bu sorunla karşılaşmaya devam ederseniz işleme miktarını en üst düzeye çıkarmak için bir kanal havuzu yapılandırmanız gerekebilir. Bu, birden fazla temel bağlantıyı yöneterek tek bir gRPC kanalının normal 100 akış sınırını atlar. Daha fazla bilgi için Eşzamanlı istekler için kodu yeniden düzenleme: Kanal havuzlarıyla işleme kapasitesini artırma başlıklı makaleyi inceleyin.
Özel karakterler içeren ürün tanımlayıcıları
Bildirim tarihi: 03.10.2025 UTC | Son güncelleme: 08.04.2026 UTC
Kullanıcılar, productId veya offerId değerinin ürün kimliği biçimlendirme kurallarına uymadığı ürünleri yönetirken sorunlarla karşılaşabilir.
Bu tür ürün kimlikleri, özel karakterler (özellikle eğik çizgi (/), iki nokta üst üste (:), tilde (~) ve yüzde işaretleri (%)) içerebilir. Merchant Center gibi platformlar, ürün kimliklerinde bazı özel karakterlere zaten izin verir.
Merchant API, ürün tanımlayıcıyı URL'nin bir parçası olarak doğrudan kaynak name içine eklediğinden (ör. accounts/{account}/products/{productId}) bu karakterler standart URL yönlendirmesini ve ayrıştırmasını engelleyebilir. Bu durum, GET, PATCH veya DELETE işlemleri sırasında beklenmedik 404 Not Found ya da 400 Bad Request hatalarına yol açabilir.
Bu karakterleri içeren ürünlerle güvenli bir şekilde etkileşim kurmak için kaynak adının productId veya offerId segmentini kodlamanız gerekir. Kodlama algoritması, dolgu içermeyen Base64URL kodlamasıdır. Daha fazla bilgi için accounts.productInputs.name konusuna bakın.
Çözüldü: Merchant API ekosistemindeki davranışı standartlaştırmak için bir çözüm sunduk. API yanıtlarına, önceden kodlanmış kaynak adını sağlayan yeni bir base64_encoded_name alanı ekledik. Bu alan, manuel kodlama yapmadan bir listenin çıkışını kullanmanıza veya doğrudan sonraki güncellemeler için giriş olarak çağrı almanıza olanak tanır.
Veri kaynağı oluşturulduktan sonraki gecikme
Bildirim tarihi: 10 Nisan 2024 UTC | Son güncelleme: 12 Mayıs 2024 UTC
Yeni bir DataSource oluşturduktan hemen sonra ürün, promosyon veya yorum eklemeye çalışırken bilinen bir gecikme yaşandı. Veri kaynağı oluşturulduktan sonraki 5 dakika içinde öğe eklemeye çalışıldığında Data source not found hatası döndürüldü.
Çözüldü: Bu gecikme ortadan kaldırıldı ve yeni oluşturulan veri kaynaklarıyla daha hızlı etkileşim kurulması sağlandı.
Başka bir sorun var mı?
Diğer sorunlar için Merchant API ile ilgili yardım alma ve Geri bildirim gönderme sayfalarımızı ziyaret edin.