Kotalar

Bu belgede, Merchant API için geçerli olan kotalar listelenmiştir.

Merchant API, tüm kullanıcılar için istikrarlı ve adil bir ortam sağlamak amacıyla kotalar kullanır. Kotalar, tek bir API kullanıcısının sisteme aşırı yük bindirmesini önleyerek yüksek performans sağlar. Bu kotaları anlamak, ürün verilerinizi yönetmek ve Google'da işletmenizi büyütmek için çok önemlidir.

Genel kavramlar

Merchant API kotaları, kota grupları aracılığıyla yönetilir.

API yöntemleri, kota gruplarıyla eşlenir. Bu eşlemenin yapısı değişebilir:

  • Grup başına tek yöntem: Bazı kota grupları tek bir API yöntemi için geçerlidir. Örneğin, listeleme veri kaynaklarını listeleme yönteminin accounts.dataSources.list kendi özel kota grubu vardır.
  • Grup başına birden fazla yöntem (paketleme): Genellikle, ilgili yöntemler tek bir kota grubunda birlikte paketlenir. Bu gruptaki tüm yöntemler aynı günlük ve dakika başına sınırlara sahiptir. Yaygın örnekler:
    • İlgili yöntemler ve kaynaklar için tüm okuma işlemlerini gruplandırma (ör. merchant-accounts-read-methods).
    • İlgili yöntemler ve kaynaklar için tüm yazma işlemlerini gruplandırma (ör. merchant-accounts-write-methods).

Her yöntem çağrısı, türüne bakılmaksızın bir kez sayılır. 250 öğelik bir list isteği, 250 get isteği olarak değil, yalnızca bir kez sayılır.

Yerleşik HTTP toplu işleme, kotayı etkilemez. İstek grubundaki her bir istek, kotaya karşı bir istek olarak sayılır. Örneğin, 500 insert isteği içeren bir toplu isteğin ücreti, 500 ayrı insert yöntemi isteği olarak alınır.

Özel bölge toplu işleme istisnası: Özel bölge toplu işleme yöntemleri (batchCreate, batchUpdate, batchDelete) yükte bulunan bölge işlemleri sayısından bağımsız olarak merchant_regions kota grubu için tek bir API çağrısı olarak sayılır.

Entegrasyonunuzu etkili bir şekilde yönetmek için kullanmayı planladığınız her API yöntemiyle ilişkili belirli kota grubunu incelemeniz gerekir. Bu ayrıntıları kotalar listesi yönteminde bulabilirsiniz. Daha fazla bilgi için İzleme ve Görünürlük başlıklı makaleyi inceleyin.

Politikayı güncelleme

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

  • Varsayılan olarak, ürünlerinizi günde en fazla iki kez güncelleyebilirsiniz. Dakika başına kota sınırına uymak için aramaları gün içine eşit şekilde yaymanız gerekir.
  • Varsayılan olarak, alt hesaplarınızı günde yalnızca iki kez güncelleyebilirsiniz. Günlük alt hesap güncelleme kotanız, izin verilen toplam alt hesaplarınıza göre belirlenen toplu bir sınırdır.
  • Varsayılan olarak, alt hesaplarınız için veri kaynağı yöntemlerini (ör. list veya create) günde alt hesap başına en fazla iki kez çağırabilirsiniz.

Hız kotaları

Her kota grubunda iki tür sınır (ve günlük kullanım) bulunur:

  • Günlük sınır (quotaLimit): Günlük izin verilen maksimum istek sayısı. Günlük kota sınırları 12:00'de (UTC) sıfırlanır.
  • Dakika sınırı (quotaMinuteLimit): Dakika başına izin verilen maksimum istek sayısıdır ve isteklerin sıklığını kontrol eder. Dakikadaki kota sınırlarında, yaptırım süresinin söz konusu yöntem ve kaynak için ilk API çağrısının yapıldığı andan itibaren başladığı bir kayan pencere kullanılır. Örneğin, 10:01:30'da bir arama yaparsanız bu yöntem için dakika başına kota penceresi 10:02:30'a kadar devam eder.
  • Günlük Kullanım (quotaUsage): Geçerli gün için günlük sınıra göre halihazırda gönderilmiş ve sayılmış olan isteklerin sayısı. Alan eksikse bu grup için henüz kota kullanılmamıştır.

Daha önce açıklanan üç alanı (quotaLimit, quotaMinuteLimit ve quotaUsage) quotas.list yönteminin yanıtında bulabilirsiniz.

Günlük ve dakika başına sınırların farklı kota grupları arasında önemli ölçüde değiştiğini unutmayın. Ürün verilerini okuma gibi, beklenen hacmi daha yüksek veya sistem maliyeti daha düşük olan işlemlerin sınırları genellikle daha yüksektir. Buna karşılık, hesap değişiklikleri gibi daha yoğun veya hassas işlemlerin sınırları daha düşük olabilir.

Kota ayırma ve hiyerarşi

Bu bölümde, Merchant API'nin kota kullanımını kimin adına izlediği ve uyguladığı açıklanmaktadır:

Genel olarak kota, API isteğinde bulunan kullanıcıya göre ücretlendirilir.

  • Bağımsız hesaplar: Bir API çağrısını kimlik doğrulayan bağımsız hesaplar için bu istek, söz konusu hesabın kotasına göre değerlendirilir.
    • Örnek: Ayakkabı Mağazası A (Hesap Kimliği: 12345) adlı bir satıcı, kendi hesabını (accounts/12345) hedefleyen products.insert işlevini çağırmak için kendi hizmet hesabını kullanarak kimlik doğrulaması yapar. Kota, Ayakkabı Mağazası A'nın kota havuzundan kullanılır.
  • Gelişmiş hesaplar: Gelişmiş hesap olarak kimlik doğrulama, alt hesap hedeflenirken bile gelişmiş hesabın havuzundaki kotayı tüketir.
    • Örnek: Bir ajansın Perakende Yönetim Hesabı (Gelişmiş Hesap Kimliği: 12345), Giyim Mağazası B adlı bir alt hesabı (Hesap Kimliği: 11111) yönetiyor. Ajans, kendi kimlik bilgilerini kullanarak kimlik doğrulaması yapar ve Giyim Mağazası B'yi (accounts/11111) hedefleyen products.insert çağrıları yapar. Kota, alt hesabın havuzundan değil, üst ajansın havuzundan (Gelişmiş Hesap Kimliği: 12345) kullanılır.
  • Alt hesaplar: API çağrıları bir alt hesabın kimlik bilgileri kullanılarak kimliği doğrulandığında kota, söz konusu alt hesabın bireysel havuzundan alınır. Bu hesap, bir üst gelişmiş hesap tarafından yönetilse de bağımsız bir hesapla aynı şekilde çalışır.
    • Örnek: Öncekiyle aynı kurulum kullanıldığında, B Giyim Mağazası (Hesap Kimliği: 11111) kendi hesabını (accounts/11111) hedefleyen products.insert çağrısı yapmak için özellikle alt hesabı için oluşturulan kimlik bilgilerini kullanarak kimlik doğrulaması yaparsa kota, B Giyim Mağazası'nın bireysel kota havuzundan kullanılır ve üst ajansın havuzu etkilenmez.

Genel kurallarla ilgili istisnalar

Kota tahsisiyle ilgili genel kurallara uygulanan birkaç istisna vardır:

  • Accounts.list: Bu yöntemin kotası, Merchant Center hesap kimliğine göre değil, çağrıyı yapan kimliği doğrulanmış kullanıcıya veya hizmet hesabına göre ücretlendirilir. Kota kullanımı, standart Merchant Center API teşhis sayfasında görünmez. Gelişmiş hesabınız varsa gelişmiş hesap kotanıza dahil olan accounts.listSubaccounts yöntemini kullanmanızı öneririz.
  • Sorun çözme yöntemleri: Bu yöntemler, farklı bir hesap isteğin kimliğini doğruluyor olsa bile, sorunları istenen hesabın kotasına göre her zaman sayılır.

Ayırma Hiyerarşisi

  • Karşılaştırmalı Alışveriş Hizmetleri (CSS'ler): CSS'ler, ürün tekliflerini toplayan ve kullanıcıları satın alma işlemi yapmaları için perakendecilerin web sitelerine yönlendiren web siteleridir. API çağrıları yapılırken kotalar, kimlik doğrulama yaptığınız belirli CSS grubu, CSS alanı, hesap veya alt hesaba uygulanır.

    Örnekler:

    • Europe Shopping Group adlı bir CSS grubu (hesap kimliği: 10001), ilişkili CSS alanlarını listelemek istiyor. Bu API çağrısını yapmak için kendi kimlik bilgileriyle kimlik doğrulandığında kota doğrudan Europe Shopping Group kota havuzundan kullanılır.
    • Bir CSS alanı olan TopDeals CSS (hesap kimliği: 20002), bir etiketi atamak için ilişkili satıcı hesaplarından birini (accounts/30003) hedefleyen bir yöntemi çağırmak üzere kimlik doğrulaması yapar. Kota, satıcı hesabının havuzundan değil, TopDeals CSS'nin kota havuzundan kullanılır.

  • Pazar yerleri: Pazar yerleri, birden fazla satıcıyı barındıran online platformlardır. Bu hesaplar, her satıcınız için ayrı alt hesaplar oluşturmanıza olanak tanıyan özel gelişmiş hesaplar olarak işlev görür.

Aşağıdaki şemada CSS grupları, CSS'ler, pazar yerleri, gelişmiş hesaplar, bağımsız hesaplar ve alt hesapların hiyerarşisi gösterilmektedir.

CSS grubu, genel kimlik doğrulama düzeyidir. Bu düzeyde, CSS'ler, bu CSS'lerin içinde hesaplar ve en bireysel düzey olarak alt hesaplar yer alabilir.

Otomatik Kota Ayarı

Merchant API, belirli hizmetler için otomatik bir kota yönetim sistemine sahiptir. Bu sistem, kullanımınıza, teklifinize ve hesap boyutunuza göre büyüyen satıcıların kota sınırlarını ayarlar. Merchant API, bu kotaları günlük olarak yeniden hesaplar.

Otomatik kota ayarlamalarına dahil edilen kota grupları şunlardır:

Ürün hizmetleri

  • products ve productInputs kaynaklarıyla ilgili tüm yöntemlerin kota grupları.
  • Günlük arama kotası genellikle satıcının teklif kotasının 2 katı olarak belirlenir. Bu, bir satıcının ürünlerinin her birini günde iki kez güncellemesi gerekebileceği varsayımına dayanır.
  • Tek tek ürünler ikiden fazla güncellenebilir ancak genel günlük API çağrılarınız, toplam günlük çağrı kotasını aşamaz.

Hesap hizmetleri

  • Merchant API'deki çeşitli ayrıntılı hesapla ilgili kaynaklarla ilişkili tüm yöntemlerin kota grupları.
  • Günlük çağrı kotası, söz konusu hesap için izin verilen maksimum alt hesap sayısına ayarlanır. Bu, alt hesap başına günde en fazla iki okuma çağrısı yapılmasını sağlar.

Veri kaynağı hizmetleri

  • Gelişmiş bir hesabın alt hesaplarında gerçekleştirdiği, Merchant API'deki veri kaynağıyla ilgili kaynaklarla ilişkili tüm kota grupları (ör. list veya create).
  • Günlük arama kotası genellikle gelişmiş hesabın sahip olduğu alt hesap sayısının 2 katı olarak ayarlanır. Bu, bir satıcının alt hesaplarının her birinin veri kaynaklarını günde en fazla iki kez güncelleyebileceği varsayımına dayanır.

Yalnızca daha önce açıklanan hizmetlerde otomatik kota ayarlamaları yapılır. Diğer hizmetlerin varsayılan kotası vardır ve artışlar manuel olarak istenmelidir. Daha fazla bilgi için Kota artışı süreci bölümüne bakın.

Kotalar aşıldığında ne olur?

Kota aşıldıktan sonra API yanıtlarında ve Merchant Center hesabınızdaki teşhis sayfasında hatalar görünür:

  • Dakikada: quota/request_rate_too_high
{
    "error": {
        "code": 429,
        "message": "Quota per minute exceeded. Please distribute your requests over a longer time period. For more information check https://developers.google.com/merchant/api/guides/quotas-limits",
        "status": "RESOURCE_EXHAUSTED",
        "details": [
            {
                "@type": "type.googleapis.com/google.rpc.ErrorInfo",
                "reason": "quotaExceeded",
                "domain": "merchantapi.googleapis.com",
                "metadata": {
                    "HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/quotas-limits",
                    "REASON": "QUOTA_REQUEST_RATE_TOO_HIGH"
                }
            }
        ]
    }
}
  • Günlük: quota/daily_limit_exceeded
{
    "error": {
        "code": 429,
        "message": "Daily request quota exceeded. Please reduce number of requests. For more information check https://developers.google.com/merchant/api/guides/quotas-limits",
        "status": "RESOURCE_EXHAUSTED",
        "details": [
            {
                "@type": "type.googleapis.com/google.rpc.ErrorInfo",
                "reason": "quotaExceeded",
                "domain": "merchantapi.googleapis.com",
                "metadata": {
                    "HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/quotas-limits",
                    "REASON": "QUOTA_TOO_MANY_REQUESTS"
                }
            }
        ]
    }
}

Aşağıdaki hatalar Merchant Center sınırlarıdır ve Merchant API kotalarıyla ilgili değildir. Öğeler, feed'ler veya alt hesaplar için ek kota isteğinde bulunmayı deneyebilirsiniz:

  • too_many_items: Satıcı kotası aşıldı
  • too_many_subaccounts: Maksimum alt hesap sayısına ulaşıldı

İzleme ve görünürlük

Bir hesabın mevcut çağrı kotalarını ve kullanımını kontrol etmek için hesabın adıyla quotas.list işlevini çağırın.

POST https://merchantapi.googleapis.com/quota/v1/accounts/{ACCOUNT_ID}/quotas
Content-Type: application/json
Authorization: Bearer {ACCESS_TOKEN}

Aşağıdakini değiştirin:

  • ACCOUNT_ID: Merchant Center kimliğiniz
  • ACCESS_TOKEN: API çağrısı yapmak için kullanılan yetkilendirme jetonu

İstek başarılı olduğunda API, kota grubunun kaynağını (name), farklı kotaları ve grup kotasının uygulandığı yöntemleri içeren quotaGroups kaynaklarının bir listesini döndürür.

{
    "quotaGroups": [
        {
            "name": "accounts/{ACCOUNT_ID}/quotas/merchant-quota-listquotagroups",
            "quotaUsage": "2",
            "quotaLimit": "1000",
            "methodDetails": [
                {
                    "method": "quotaservice.listquotagroups",
                    "version": "v1",
                    "subapi": "quota",
                    "path": "quota/v1/quotaservice.listquotagroups"
                }
            ],
            "quotaMinuteLimit": "10"
        },
        {
            "name": "accounts/{ACCOUNT_ID}/quotas/merchant-commission-group-list",
            "quotaLimit": "10000",
            "methodDetails": [
                {
                    "method": "commissiongroupservice.listcommissiongroups",
                    "version": "v1",
                    "subapi": "youtube",
                    "path": "youtube/v1/commissiongroupservice.listcommissiongroups"
                }
            ],
            "quotaMinuteLimit": "60"
        },
        {
            "name": "accounts/{ACCOUNT_ID}/quotas/merchant-merchantreviews-list",
            "quotaLimit": "20000000",
            "methodDetails": [
                {
                    "method": "merchantreviewsservice.listmerchantreviews",
                    "version": "v1",
                    "subapi": "reviews",
                    "path": "reviews/v1/merchantreviewsservice.listmerchantreviews"
                }
            ],
            "quotaMinuteLimit": "60000"
        }
    ]
}

Kota artışı süreci

Ek kota isteğinde bulunmak için Destek ekibiyle iletişime geçme formunu açın, gerekli "Sorun/Soru Nedir?" alanı için Kota artışı isteği'ni seçin ve Merchant Center kimliğiniz, hedef yöntemleriniz ve işletme gerekçeniz dahil olmak üzere tüm zorunlu alanları doldurun.

  • Otomatik kotalara sahip kaynaklar (products, accounts ve gelişmiş hesaplar için datasources): Yalnızca yeni bir pazarda kullanıma sunma veya yoğun trafikli alışveriş sezonları gibi özel senaryolar için geçici bir artış isteğinde bulunabilirsiniz. Bu tür kaynaklar için kalıcı kota artışlarını kabul etmiyoruz.
  • Otomatik kotaları olmayan diğer tüm kaynaklar için: Gerekli olduğu durumlarda kota artışı isteğinde bulunun.

Uygulamanız için yeterli kotanız olduğundan emin olmak ve kotanızın nasıl otomatik olarak ayarlandığını görmek için kotalarınızı düzenli olarak kontrol etmenizi öneririz. Her API yöntemi grubu için geçerli günlük kota sınırınızı, dakika sınırınızı ve geçerli günlük kullanımınızı görmek üzere quotas.list yöntemini kullanın.

En İyi Uygulamalar

Bu en iyi uygulamaları kullanmak, entegrasyonunuzun sorunsuz çalışmasını, beklenmedik kota hatalarını önlemenizi ve Merchant Center kaynaklarını verimli bir şekilde kullanmanızı sağlar.

İstek dağıtımını optimize etme

  • İstekleri eşit şekilde dağıtın: Büyük istek grupları göndermeyin. Dakika başına kota sınırları (quotaMinuteLimit) içinde kalmak için günlük API çağrılarınızı gün boyunca eşit şekilde dağıtın.
  • Proaktif Sınırlama: Uygulamanızda istemci taraflı hız sınırlaması (sınırlama) uygulayın. Aşırı trafiği reddetmek için yalnızca Google'ın sunucularına güvenmeyin. İstek oranınızı kaynakta kontrol edin.

Kontrollü Hata İşleme

  • HTTP 429'u işleme: Uygulamanız, 429 Too Many Requests hatalarını (quota/request_rate_too_high) işleyecek şekilde hazırlanmalıdır.
  • Jitter ile Eksponansiyel Geri Yükleme: Başarısız istekleri (özellikle 429'dan sonra) yeniden denerken eksponansiyel geri yükleme (bekleme sürelerini artırma) kullanın ve "jitter" (rastgele gecikme) ekleyin. Jitter, birden fazla istemci örneğinin tam olarak aynı anda yeniden denediği ve sunucuyu tekrar aşırı yüklediği "yeniden deneme fırtınalarını" önler.
  • Yeniden Deneme İpuçlarına Uyun: API yanıtı yeniden deneme ayrıntıları veya başlıkları içeriyorsa çağrıları ne zaman sürdüreceğinizi belirlemek için bunları kullanın.

Gereksiz çağrıları en aza indirme

  • Eski Çağrıları Önleme (404 NOT_FOUND): Artık mevcut olmayan kaynakları istemekten veya silmekten kaçının. Başarısız çağrılar bile API kotasını tüketir. Eski durum izlemeyi veya gereksiz yoklamayı tespit etmek için Merchant Center API Teşhis Aracı'ndaki hataları NOT_FOUND izleyin.
  • Güncellemeden Önce Doğrulama: Güncelleme isteği göndermeden önce verilerin gerçekten değişip değişmediğini kontrol edin. Aynı değerleri yazan güncellemeler göndermekten kaçının.
  • Önbelleğe Alma İşlemini Kullanma: Değişmeyen veriler için tekrarlanan get veya list çağrılarını önlemek amacıyla okuma yanıtlarını (ör. ürün ayrıntıları, ayarlar) uygun olduğunda yerel olarak önbelleğe alın.
  • Gelişmiş hesaplar ve alt hesaplar: Gelişmiş hesap kullanıyorsanız aramaların gelişmiş hesabın paylaşılan havuzuna dahil edilmesini istiyorsanız gelişmiş hesap düzeyinde kimlik doğrulama yapın.
  • listSubaccounts kullanma: Gelişmiş hesaplarda accounts.list yerine accounts.listSubaccounts kullanın. accounts.list kotası, arayan kullanıcıdan (MC kimliğinden değil) alınır ve standart teşhislerde görünmez. listSubaccounts, MM kotanızdan düşülür.
Önceki
Overview
Sonraki
Merchant Center limits