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

Bu belgede, Management API'leri ve Reporting API'leri istemeyle ilgili sınırlar ve kotalar açıklanmaktadır.

Google Analytics milyonlarca site tarafından kullanılmaktadır. Sistemi işleyebileceğinden daha fazla veri almasını önlemek ve sistem kaynaklarının adil bir şekilde dağıtılmasını sağlamak için API isteklerine sınırlar ve kotalar uygularız. Sınırlar ve kotalar değişikliğe tabidir.

Bu videoda, Google Analytics API istek kotalarını yönetmeyle ilgili en iyi uygulamalar anlatılmaktadır.

Genel kota sınırları

Aşağıdaki kotalar Management API'si, Core Reporting API v3, MCF Reporting API, Metadata API, User Deletion API ve Real Time Reporting API için geçerlidir:

  • Proje başına günlük 50.000 istek. Bu artırılabilir.
  • IP adresi başına saniyede 10 sorgu (QPS).
    • API Konsolu'nda, Kullanıcı başına 100 saniyedeki istek sayısı adlı benzer bir kota bulunur. Varsayılan olarak kullanıcı başına 100 saniyede 100 istek olacak şekilde ayarlanmıştır ve maksimum 1.000 değerine ayarlanabilir. Ancak API'ye gönderilen isteklerin sayısı, kullanıcı başına saniyede maksimum 10 istekle sınırlandırılmıştır.
    • Uygulamanız tüm API isteklerini tek bir IP adresinden yapıyorsa (kullanıcılarınız adına) her kullanıcı için tam QPS kotası almak amacıyla 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, Real Time API v3 ve Multi-channel Funnel API v3 dahil olmak üzere tüm Reporting API'leri için geçerlidir:

  • Görüntüleme (profil) başına günde 10.000 istek (artırılamaz)
  • Görünüm (profil) başına 10 eşzamanlı istek (artırılamaz)

API istek hatalarını bildirme

Reporting API'ye yaptığınız istek bir sunucu hatasıyla başarısız olursa yanıt kodu 500 veya 503 alırsınız. İsteği yeniden gönderebilirsiniz, ancak tekrar tekrar başarısız olursa bu isteği birden fazla kez yeniden göndermeyin. Google Analytics şunları sağlar:

  • Proje başına, görünüm (profil) başına saatlik 10 sunucu hatası başarısız isteği
  • Proje başına, görünüm (profil) başına günlük 50 sunucu hatası başarısız isteği

Başarısız isteklerinizin sayısı bu kotaları 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 hatası olasılığını azaltmak için tarih aralığını kısaltarak, istekteki boyutların sayısını veya istekteki metriklerin sayısını azaltarak isteği basitleştirin.

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

Sunucu hata oranı kotaları, saatlik ve günlük hata oranı kotalarının her biri için periyodik zaman aralıklarında uygulanır. Bir proje ve çiftin ilk sunucu hatasını görüntüledikten bir saat sonra kota sıfırlanır. Bir proje ve görünüm çifti bir saat içinde 10 sunucu hatası gönderirse ilk sunucu hatası geçtikten sonraki bir saat boyunca proje ve görünüm çifti API'den 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üm 50 kotasının 0'ını kullanmış olur. Bu proje ve görünümün 06:12'de bir sunucu hatası gönderdiğini düşünelim. Bu proje ve görünüm ertesi gün 06:12'den önce 49 ek sunucu hatası daha gönderirse bu proje ve görünüm ertesi gün 06:12'ye kadar engellenir. Ertesi gün 06:12'de bu proje ve görünüm için sunucu hata oranı kotası tamamen sıfırlanır.

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

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

Ek kota isteme

Yalnızca şu durumlarda artış isteğinde bulunabilirsiniz:

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ında artış isteğinde bulunmak için lütfen Analytics API kota istek formunu kullanın. İsteği göndermeden önce bilgileri incelediğinizden ve kota istek formundaki talimatları uyguladığınızdan emin olun. Reporting API v4 için Google API Konsolu'ndaki API adı Google Analytics Reporting API'dir. Diğer tüm v3 API'leri (ör. Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) Google API Konsolu'nda Analytics API bölümünde listelenmiştir.

Kota yönetimi ve uygulamanızda kota kullanımı için ince ayarlar yapma hakkında daha fazla bilgi edinmek için API'leri izleme ve kullanımı sınırlama başlıklı makaleye göz atın.