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öntemi, update yönteminden ayrı bir kotaya sahiptir.
• 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ş 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 kimliğinizi doğruladığınızda, çağrılar gelişmiş hesabınızın kotasına göre sayılır. Ancak alt hesaplarınızdan biri olarak kimliğinizi doğruladığınızda, çağrılar alt hesabın kotasına göre sayılır.

Şemada CSS gruplarının, CSS'lerin, hesapların ve alt hesapların hiyerarşisi gösterilmektedir.

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 isteğin ücreti 500 ayrı ekleme yöntemi isteği olarak alınır.
• 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ışı istiyorsanız, 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 ihtiyacınız olan çağrı sayısının tahmini
• Kota artışı isteme nedeniniz
• 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, 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'daki reklamları hedefleyen ürünler için products~ADS_EEA, AEA dışındaki reklamları 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ılmaz.

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