Veri API'si sınırları ve kotaları

Data API için aşağıdaki sınırlar ve kotalar geçerlidir.

Kotalar nasıl uygulanır?

Google Analytics Data API v1'e yapılan tüm istekler için bir Google Cloud projesi gerekir ve bu sayfada belirtilen kotalara tabidir. Kotalar, arayan projeyi tanımlamak için kullanılan yöntemden bağımsız olarak tüketilir. Bu yöntemler arasında şunlar yer alır:

  • OAuth 2.0 kimlik bilgileriyle kimliği doğrulanmış istekler.
  • Yalnızca API anahtarı kullanılarak kimliği doğrulanmış istekler.

API anahtarları, kota ve faturalandırma amacıyla bir isteği belirli bir Google Cloud projesiyle ilişkilendirmek için kullanılır. Projenizdeki kimlik bilgileri veya API anahtarı kullanılarak yapılan tüm API çağrıları, projenizin ve Google Analytics mülkünün geçerli kotalarına göre değerlendirilir.

Kota kategorileri

Data API'nin üç istek kotası kategorisi vardır: Temel, Gerçek Zamanlı ve Dönüşüm Hunisi. Temel yöntemlere yapılan API istekleri, temel kotalardan düşülür. Gerçek Zamanlı yöntemlerine yapılan API istekleri, Gerçek Zamanlı kotalarını kullanır. Her istek yalnızca bir tür kota tüketir.

Kota kategorisi API yöntemleri
Core runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports
Gerçek zamanlı runRealtimeReport
Dönüşüm hunisi runFunnelReport

Analytics mülkü kotaları

Tüm istekler mülk kotalarını tüketir.

Kota Adı Standart mülk sınırı Analytics 360 mülk sınırı
Mülk Başına Günlük Çekirdek Jeton Sayısı 200.000 2.000.000
Mülk Başına Saatlik Çekirdek Jeton Sayısı 40.000 400.000
Saat Başına Mülk Başına Proje Başına Çekirdek Jetonu 14.000 140.000
Mülk Başına Eşzamanlı Temel İstek Sayısı 10 50
Proje Başına Mülk Başına Saatlik Temel Sunucu Hataları 10 50
Mülk başına günlük gerçek zamanlı jeton sayısı 200.000 2.000.000
Mülk başına saatlik gerçek zamanlı jeton sayısı 40.000 400.000
Gerçek Zamanlı Jetonlar (Proje Başına, Mülk Başına, Saat Başına) 14.000 140.000
Mülk Başına Eşzamanlı Gerçek Zamanlı İstekler 10 50
Proje başına, mülk başına, saatte gerçek zamanlı sunucu hataları 10 50
Mülk başına günlük dönüşüm hunisi jetonu sayısı 200.000 2.000.000
Mülk başına saatlik dönüşüm hunisi jetonları 40.000 400.000
Proje başına, mülk başına saatlik dönüşüm hunisi jetonları 14.000 140.000
Mülk Başına Eşzamanlı Dönüşüm Hunisi İstekleri 10 50
Dönüşüm hunisi, proje, mülk başına saatlik sunucu hataları 10 50
  • Eşzamanlı istekler, aynı anda yürütülen isteklerin sayısıyla ölçülür. İstek eşzamanlılığınızı azaltmak için ek istek göndermeden önce önceki isteklerin tamamlanmasını bekleyin.
  • Sunucu hataları 500 ve 503 kodlarıdır. Sunucu hataları kotaları yalnızca bir istek sunucu hatasıyla sonuçlandığında ücretlendirilir. Bir proje ve mülk çifti için sunucu hataları kotaları tükendiğinde, projeden mülke yapılan tüm istekler engellenir.
  • Her istek, hem Mülk Başına Saatlik Jeton hem de Proje Başına Mülk Başına Saatlik Jeton kotasını tüketir. Bu, "Proje Başına Mülk Başına Saatlik Jeton" kotası dolmadan önce "Mülk Başına Saatlik Jeton" kotasının dolması için bir mülke 3'ten fazla proje tarafından erişilmesi gerektiği anlamına gelir.

Mülklerin saatte 120 eşikli istek göndermesine izin verilir. userAgeBracket, userGender, brandingInterest, audienceId ve audienceName boyutları eşiklenmiş olabilir. Eşikler, raporları görüntüleyen kişilerin bağımsız kullanıcıların demografisi ve ilgi alanları üzerinde çıkarımlar yapmasına engel olmak için uygulanır.

Mülk jetonları kotası

Jetonlar, isteğin karmaşıklığına bağlı olarak her istekte hesaplanır. Çoğu istek için 10 veya daha az jeton ücreti alınır. Bir istek tarafından çok sayıda kota jetonu tüketildiğinde genellikle şu faktörler etkili olur:

  • Çok sayıda satır
  • Çok sayıda sütun
  • Karmaşık filtre ölçütleri
  • Uzun tarih aralığı

Her API isteğinde, mevcut mülk kotası jetonlarının durumunu döndürmek için istek gövdesinde "returnPropertyQuota": true belirtebilirsiniz. Bu durum, hem bu istek tarafından tüketilen miktarı hem de her kota grubu için kalan miktarı içerir. Örneğin, bu parametreyi RunReportRequest içinde belirtmeyi düşünebilirsiniz.