Kotalar ve sınırlar

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

Politika güncelleme

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

  • Ürünlerinizi günde en fazla iki kez güncelleyebilirsiniz.
  • 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, bir kez sayarız.
  • Kota, API isteğini yapan kullanıcıya göre ücretlendirilir. Kullanıcı, gelişmiş bir hesabın doğrudan üyesiyse kota, gelişmiş hesap düzeyinde ücretlendirilir.
  • Kotalar, arama yaptığınızda kimliğinizi doğruladığınız Comparison Shopping Service (CSS) grubu, CSS, hesap veya alt hesaplar için 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şikliklerine dikkat edin:

  • Özel toplu işleme özelliğinin olmaması kota hesaplamasını etkilemez. Örneğin, 500 ekleme isteği içeren bir toplu istek, 500 ayrı ekleme yöntemi isteği olarak ücretlendirilir.
  • Hesaplar ve ürünler için kota otomasyonu devam eder.
  • 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ı kotası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ışı yapmanız gerekiyorsa, 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ışı istemenizin 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

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

Kotalarınızı ve kullanımınızı görüntülemek, ayrıca günlük veya dakikalık kota artışı talep etmek için Arama 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 istemenizi gerektirir:

  • 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, AEA'da reklam hedefleyen ürünler için products~ADS_EEA, AEA dışında reklam hedefleyen ürünler için products~ADS_NON_EEA.

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[]