API gecikmesini planlama

Gecikme, bir isteğe yanıt alana kadar geçen süredir. Bu kılavuzda, Merchant API istekleri için büyüklük sırasına göre gecikmeler verilmiştir. Zaman aşımlarını ayarlamak ve entegrasyonunuzun işleme kapasitesini planlamak için bu değerleri kullanın.

Çoğu Merchant API isteği bir saniyeden kısa sürede tamamlanır. Yerel ve bölgesel envanter güncellemeleri birkaç saniye sürebilir ve bazı rapor sorguları çok daha uzun sürer.

Olağan gecikmeler

Aşağıdaki tabloda, istek türüne göre yaklaşık gecikmeler listelenmiştir. Tipik gecikme, ortanca değerdir: İsteklerin yarısı daha hızlı tamamlanır. İsteklerin en yavaş%1'lik kısmı, son sütunda gösterilen süre kadar veya daha uzun sürer.

İstek türü Örnek yöntemler Tipik gecikme İsteklerin en yavaş% 1'i
Ürün okuma ve yazma işlemleri products.get, productInputs.insert, productInputs.patch, productInputs.delete 100 ila 600 milisaniye Yaklaşık 2 saniye
Diğer isteklerin çoğu products.list, accounts.get, dataSources.list, aggregateProductStatuses.list 1 saniyeden kısa Birkaç saniye
Yerel ve bölgesel envanter yazma işlemleri localInventories.insert, regionalInventories.insert ve ilgili delete yöntemleri Birkaç saniye 10 saniye veya daha uzun
Rapor sorguları accounts.reports.search Yaklaşık yarım saniye 30 saniye veya daha uzun

Rapor sorguları en çok değişiklik gösteren sorgulardır. Gecikme süresi, sorguladığınız rapor tablosuna ve sorgunun kapsadığı veri miktarına bağlıdır. Rapor sorgularının yaklaşık onda biri genellikle 2 saniyeden uzun sürer ve küçük bir kısmı bir dakikadan uzun sürebilir.

Öneriler

  • Zaman aşımlarını ek süreyle ayarlayın. İstemcinizde istek zaman aşımı ayarlarsanız bu değerleri, Tipik gecikmeler bölümünde listelenen en yavaş gecikmelerin çok üzerinde ayarlayın. Örneğin, 60 saniyelik bir zaman aşımı çoğu istek için yeterli bir süre olsa da tüm rapor sorguları için yeterli olmayabilir.
  • Bağımsız istekleri paralel olarak gönderin. Envanter yazma işlemleri birkaç saniye sürdüğünden bunları birbiri ardına göndermek işleme hızınızı sınırlar. Bağımsız istekleri paralel olarak gönderin veya toplu istekleri kullanın. Birden fazla istek gönderirken dakika başına ve günlük sınırlarınızı göz önünde bulundurun. Daha fazla bilgi için Ücret kotaları bölümüne bakın.
  • Rapor sorgularını ihtiyacınız olan verilerle sınırlayın. Uzun tarih aralıkları gibi büyük veri kümelerini kapsayan sorgular daha uzun sürer ve zaman aşımına uğrayabilir. Büyük miktarda veriye ihtiyacınız varsa BigQuery'yi kullanabilirsiniz. Daha fazla bilgi için Google Merchant Center verilerini BigQuery'ye yükleme başlıklı makaleyi inceleyin.
  • Eksponansiyel geri yüklemeyle yeniden deneme yapılıyor. Bir istek zaman aşımına uğrarsa veya geçici bir hatayla başarısız olursa eksponansiyel geri yükleme ile yeniden deneyin.

İşlem süresi

Verileri değiştiren isteklerde başarılı bir yanıt, Merchant API'nin değişikliği kabul ettiği ancak işlemin yanıttan sonra devam ettiği anlamına gelir. İşleme süresi, yanıtın alınmasından değişikliğin diğer kaynaklarda görünür hale gelmesine kadar geçen süredir. İşleme süresi, gecikme süresine dahil değildir ve çok daha uzun olabilir. Örneğin, işlenen ürünün eklenen ürün girişini yansıtması birkaç dakika sürebilir.

Verilerinizin işlenmiş son durumu hakkında daha fazla bilgi için aşağıdaki kılavuzları inceleyin: