Kotalar ve sınırlar

Satıcı hesabınız ve Merchant API kullanımınız kotalara ve sınırlara tabidir.

Güncelleme politikası

Merchant API, güncellemelerle ilgili olarak aşağıdaki politikaları uygular:

  • Ürünlerinizi günde en fazla iki kez güncelleyebilirsiniz. Dakika başına kota sınırına uymak için günlük aramaları gün boyunca eşit şekilde dağıtmanız gerekir.
  • Alt hesaplarınızı günde yalnızca bir kez güncelleyebilirsiniz.

Yöntem çağrısı kotaları

Merchant API, kullanımınıza bağlı olarak products ve accounts için çağrı kotalarını otomatik olarak ayarlar.

Kota kullanımınız şu şekilde izlenir:

  • Kotalar yöntem başına belirlenir. Örneğin, get yönteminin update yönteminden ayrı bir kotası vardır.
  • Her istek, türüne bakılmaksızın bir kez sayılır. Örneğin, 250 öğelik bir list isteğini 250 get isteği olarak değil, tek bir istek olarak sayarız.
  • Kota, API isteğini yapan kullanıcıya göre ücretlendirilir. Kullanıcı, gelişmiş hesabın doğrudan bir üyesiyse kota, gelişmiş hesap düzeyinde ücretlendirilir.
  • Aramayı yaptığınızda kimlik doğrulama işlemi gerçekleştirdiğiniz Comparison Shopping Services (CSS) grubu, CSS hesabı veya alt hesaplar için kotalar geçerlidir. Örneğin, gelişmiş hesap olarak kimlik doğrulaması yaparsanız çağrılar, gelişmiş hesabınızın kotasına göre değerlendirilir. Ancak alt hesaplarınızdan biri olarak kimlik doğrulaması yaparsanız çağrılar, alt hesabın kotasına göre değerlendirilir.

Şemada CSS gruplarının, CSS'lerin, hesapların ve alt hesapların hiyerarşisi gösterilmektedir. CSS grubu, kapsamlı kimlik doğrulama düzeyidir. Bu düzeyde bağımsız CSS'ler, bu CSS'lerin içinde hesaplar ve en bağımsız düzey olarak alt hesaplar yer alabilir.

Content API for Shopping'deki yöntem çağrısı kotası değişiklikleri

Content API for Shopping'i kullandıysanız Merchant API'deki aşağıdaki yöntem çağrısı kotası değişikliklerini unutmayın:

  • Özel toplu işleme özelliğinin olmaması kota hesaplamasını etkilemez. Örneğin, 500 ekleme isteği içeren bir toplu isteğin ücreti 500 ayrı ekleme yöntemi isteği olarak alınır.
  • Hesaplar ve ürünler için kota otomasyonu devam etmektedir.
  • Otomasyon ve geçersiz kılmalar dahil olmak üzere mevcut kota kullanımınızı ve sınırlarınızı belirlemek için Quota.list yöntemini kullanın.

Arama kotalarınızı kontrol etme

Bir hesabın mevcut çağrı kotalarını ve kullanımını kontrol etmek için hesabın name ile quotas.list çağrısını yapın.

Otomatik kota yalnızca products ve accounts hizmetleri için geçerlidir. Başka bir hizmet için kota artışına ihtiyacınız varsa, products veya accounts hizmetleri için günlük kotanıza ulaşıyorsanız ya da accounts veya services ürünleri için geçici bir artışa ihtiyacınız varsa aşağıdaki bilgilerle bize ulaşın:

  • Merchant Center kimliğiniz
  • Kota sınırlarına ulaştığınız yöntemler
  • Bu yöntemler için günlük olarak ihtiyaç duyduğunuz çağrı sayısının tahmini
  • Kota artışına ihtiyacınızın nedeni
  • Artışın geçici mi yoksa kalıcı mı olduğu

Uygulamanız için yeterli kotanız olduğundan veya kotanızın otomatik olarak nasıl ayarlandığından emin olmak için kotalarınızı düzenli olarak kontrol etmenizi öneririz.

Hatalar

Kotayı aşarsanız aşağıdaki hataları alırsınız:

  • Dakika başına: quota/request_rate_too_high
  • Günlük: quota/daily_limit_exceeded

Kotanızı ve kullanımınızı görüntülemek, günlük veya dakikalık kota artışı talep etmek için Çağrı kotalarınızı kontrol etme başlıklı makaleyi inceleyin.

Aşağıdaki hatalar otomatik kota artışlarıyla çözülemez ve öğeler, feed'ler veya alt hesaplar için ek kota istemeniz gerekir:

  • too_many_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

Hesap sınırları

accounts.limits.get ve accounts.limits.list yöntemleri, hesap düzeyindeki varlıklarla ilgili sınırları kontrol etmenize olanak tanır. Ürün sınırlarını kontrol etmek için bu yöntemleri kullanabilirsiniz.

Belirli bir ürün sınırını almak için (ör. bir hesabın reklamlar için AEA kotasını almak) accounts.limits.get çağrınızda hesap kimliğini ve sınır kimliğini belirtmeniz gerekir. Sınır kimliği, sınır türü ve kapsamının birleşimidir. Örneğin, products~ADS_EEA AEA'da reklam hedefleyen ürünler için, products~ADS_NON_EEA ise AEA dışında reklam hedefleyen ürünler için kullanılır.

Belirli bir hesap için products~ADS_EEA sınırını almak üzere gönderilen örnek isteği aşağıda bulabilirsiniz:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Hesabınız için kullanılabilen sınır kimlikleri hakkında bilgi edinmek üzere type="products" filtresiyle birlikte accounts.limits.list kullanın:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Ürün kotaları hakkında daha fazla bilgi için Google Merchant Center'daki kotalar hakkında başlıklı makaleyi inceleyin.

Kaynak temsili sınırları

Aşağıdaki sınırlar, Merchant API'de kullanılan kaynak temsillerindeki belirli dize değerleri ve dizi alanları için önemli kısıtlamaları açıklar. Bu sınırlar hem Merchant API hem de Merchant Center'daki ilgili özellik için aynıdır.

Bu sınır listesinin tam olmayabileceğini unutmayın. Bu sınırlar artırılamaz.

Kaynak Alan Sınır
shippingsettings

Ülke başına kargo hizmetleri (services).

Kargo hizmeti başına kargo grupları (rateGroups).

Kargo grubu başına etiketler (applicableShippingLabels).

Kargo grubu başına alt tablolar (subtables).

Tek bir ücret tablosundaki satır veya sütun sayısı.

Kargo etiketlerinin uzunluğu.

20

20

30

100

150

100

Ücret tablosundaki satır veya sütun sayısı, aşağıdaki dizi alanlarını etkiler:

  • rowHeaders veya columnHeaders içindeki dizi alanları:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]
Önceki
Manage conversion sources
Sonraki
Track usage metrics