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. Sistemin 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, 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ünde 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ı adlı benzer bir kota vardır. Varsayılan olarak, kullanıcı başına 100 saniyede 100 istek şeklinde belirlenmiştir 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 (ör. kullanıcılarınız adına) her kullanıcı için tam QPS kotası 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, Real Time API v3 ve Multi-channel Funnel API v3 dahil tüm Reporting API'ler 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 isteği 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 bu istek tekrar tekrar başarısız olursa isteği birden fazla kez yeniden göndermeyin. Google Analytics şunları sağlar:

  • Proje başına, görünüm (profil) başına saatte 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 sunucusunun hata verme olasılığını azaltmak için tarih aralığını kısaltarak, istekteki boyutların sayısını azaltarak 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, reklamı yeniden göndermek için eksponansiyel geri yükleme uygulayın.

Sunucu hatası oranı kotaları, saatlik ve günlük hata oranı kotalarının her biri için zaman aralıklarına uygulanır. Bir 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 saat içinde 10 sunucu hatası gönderirse ilk sunucu hatası geçene kadar 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 varsayalım. Bu proje ve görünüm ertesi gün saat 06:12'den önce 49 ek sunucu hatası gönderirse bu proje ve görünüm ertesi gün 06:12'ye kadar engellenir. Ertesi gün saat 06:12'de bu proje ve görünüm için sunucu hata oranı kotası tamamen sıfırlanır.

Analytics Reporting API v4

Bu kotalar yalnızca Analytics Reporting API v4 için geçerlidir:

  • Proje başına günlük istek sayısı: 50.000
  • Görüntüleme (profil) başına günlük istek sayısı: 10.000 (artırılamaz)
  • Her bir proje için 100 saniye başına istek sayısı: 2.000
  • Her projede her bir kullanıcı için 100 saniyede istek sayısı: 100 (Google API Konsolu'nda 1.000'e yükseltilebilir).

Projenizin kotalarını Google API Konsolu'nda görüntüleyebilirsiniz.

Kaynak Tabanlı Kota

Analytics Reporting API v4, ayrıca Analytics 360 müşterileri için daha yüksek örnekleme eşiklerinin kullanılmasına olanak tanıyan isteğe bağlı Kaynak Tabanlı Kota'ya da tabidir.

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 şunları artırma 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 miktarının artırılmasını talep etmek için lütfen Analytics API kota istek formunu kullanın. İsteği göndermeden önce kota istek formundaki bilgileri incelediğinizden ve 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'ndaki 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 ve kullanımı sınırlama başlıklı makaleyi inceleyin.