API İstekleriyle İlgili Sınırlar ve Kotalar

Bu dokümanda, Management API'lerini ve Reporting API'lerini isteme sınırları ve kotaları açıklanmaktadır.

Google Analytics milyonlarca site tarafından kullanılır. Sistemin işleyebileceğinden daha fazla veri almasını korumak ve sistem kaynaklarının eşit şekilde dağıtılmasını sağlamak için API isteklerine sınırlar ve kotalar koyarız. Sınırlar ve kotalar değiştirilebilir.

Bu videoda, Google Analytics API istek kotalarını yönetmeyle ilgili en iyi uygulamalar açıklanmaktadır.

Genel kota sınırları

Management API, Core Reporting API v3, MCF Reporting API, Meta Veri API, User Deletion API ve Gerçek Zamanlı Raporlama API için aşağıdaki kotalar geçerlidir:

  • Proje başına günlük 50.000 istek. Artırılabilir.
  • IP adresi başına saniyede 10 sorgu (QPS).
    • API Konsolu'nda, Kullanıcı başına 100 saniyedeki istek sayısı şeklinde ifade edilen benzer bir kota bulunur. Varsayılan olarak, kullanıcı başına 100 saniyede 100 istek şeklinde ayarlanmıştır ve maksimum 1.000 değerine ayarlanabilir. Ancak API'ye yapılan isteklerin sayısı, kullanıcı başına saniyede maksimum 10 istekle sınırlandırılır.
    • Uygulamanız tüm API isteklerini tek bir IP adresinden (yani kullanıcılarınızın adına) yapıyorsa her kullanıcı için QPS kotasının tamamını almak üzere her istekte userIP veya quotaUser parametresini kullanın. Ayrıntılar için standart sorgu parametreleri özetine bakın.

Reporting APIs

Aşağıdaki kotalar, Core Reporting API v3, Analytics Reporting API v4, Gerçek Zamanlı API v3 ve Çok Kanallı Dönüşüm Hunisi API v3 dahil olmak üzere tüm Reporting API'leri için geçerlidir:

  • Görüntüleme (profil) başına günlük 10.000 istek (artırılamaz)
  • Görüntüleme (profil) başına 10 eşzamanlı istek (artırılamaz)
Analytics Gerçek Zamanlı Raporlama API'si çağrıları, diğer Analytics API'lerinden ayrı olarak hesaba katılır. Bu nedenle, Analytics Gerçek Zamanlı Raporlama API'sini kullanarak görünüm (profil) başına günde 10.000 çağrı yapılabilir ve diğer Analytics API'lerini kullanarak görünüm (profil) başına günde 10.000 çağrı daha yapılabilir.

Bu davranış, kota yönetiminde daha ayrıntılı ve başarısız olmayan bir yaklaşım sağlar. Böylece Analytics Gerçek Zamanlı Raporlama API'sini kullanarak sık sık yapılan çağrılar, tek bir görünüm (profil) için günün geri kalanında diğer tüm Analytics API çağrılarını yanlışlıkla engellemez.

Raporlama API'leri için istek hataları

Reporting API'nize gönderdiğiniz istek sunucu hatasıyla başarısız olursa 500 veya 503 şeklinde bir yanıt kodu alırsınız. İsteği yeniden gönderebilirsiniz. Ancak istek tekrar tekrar başarısız olursa birden çok kez yeniden göndermeyin. Google Analytics şunlara olanak tanır:

  • Görünüm (profil) başına proje başına saatte 10 sunucu hatası başarısız isteği
  • Görünüm (profil) başına günlük 50 sunucu hatası başarısız istek sayısı

Başarısız isteklerinizin sayısı bu kotayı aşarsa aşağıdaki hatayı alırsınız:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

İstek sunucusu hatalarını azaltmak için tarih aralığını, istekteki boyut sayısını azaltarak veya istekteki metrik sayısını azaltarak isteği basitleştirin.

Başarısız bir isteği sürekli olarak yeniden göndermeyin. Bunun yerine, videoyu tekrar göndermek için üstel geri sayım uygulayın.

Sunucu hata oranı kotaları, saatlik ve günlük hata oranı kotalarının her biri için zaman aralıkları boyunca uygulanır. Proje ve görünüm çiftinin ilk sunucu hatasından bir saat sonra kota sıfırlanır. Bir proje ve görünüm çifti bir saatte 10 sunucu hatası gönderirse proje ve görünüm çifti, ilk sunucu hatasından sonraki saate kadar API'de engellenir.

Örneğin, bir proje ve görünüm çifti son 24 saat içinde sunucu hatası göndermediyse bu proje ve görünümde 50 kotanın 0 tanesi kullanılır. Bu projenin ve görünümün şimdi 06:12'de sunucu hatası gönderdiğini varsayalım. Bu proje ve görünüm, ertesi gün 06:12'den önce 49 ek sunucu hatası gönderirse bu proje ve görünüm, ertesi gün 06:12'ye kadar engellenecek. Bu proje ve görünüm için sunucu hata oranı kotası bir sonraki gün saat 06:12'de tamamen sıfırlanacaktır.

Kota sınırlarını aşma

Google Analytics API isteme kotası aşılırsa API 403 veya 429 hata kodu ve hesabın kotayı aştığını bildiren bir mesaj döndürür. Daha fazla bilgi için hizmet şartlarını inceleyin.

Ek kota isteme

Yalnızca aşağıdakilerin artırılmasını isteyebilirsiniz:

Projenizin kullanım sınırlarını görüntülemek, değiştirmek veya kotanızda artış talep etmek için şunları yapın:

  1. Projeniz için faturalandırma hesabınız yoksa hesap oluşturun.
  2. API Konsolu'nda API kitaplığının Etkin API'ler sayfasını ziyaret edin ve listeden bir API seçin.
  3. Kota ile ilgili ayarları görüntülemek ve değiştirmek için Kotalar'ı seçin. Kullanım istatistiklerini görüntülemek için Kullanım'ı seçin.

Maksimum kota tutarının artırılmasını istemek için lütfen Analytics API kota istek formunu kullanın. İsteği göndermeden önce bilgileri incelediğinizden ve kota istek formundaki talimatları izlediğinizden emin olun. Reporting API v4 için Google API Konsolu'ndaki API adı, Google Analytics Reporting API'dir. Diğer tüm v3 API'ler (ör. Management API v3, Core Reporting API v3, Gerçek Zamanlı Raporlama API'si v3, User Deletion API v3) Google API Konsolu'nda Analytics API'nin altında listelenmiştir.

Kota yönetimi ve kota kullanımı için uygulamanızın ince ayarlarını yapma hakkında daha fazla bilgi edinmek için API'leri izleme ve kullanımı sınırlama bölümüne bakın.