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 kotaları kullanı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, saat başına 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, saat başına 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 sunucu hataları (proje başına, mülk başına, saatlik) | 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, Google Analytics Data API v1'e yapılan her istekte kullanılır. Ücretlendirilen jeton sayısı, isteğin karmaşıklığına bağlıdır. Çoğu istek 10 veya daha az jeton tüketirken daha karmaşık istekler daha fazla jeton tüketir.
Jeton tüketimini etkileyen faktörler
Bir isteğin tam jeton maliyeti, yürütme sırasında belirlenir. Bu nedenle, önceden kesin bir hesaplama yapmak zordur. Maliyet, isteğin kendisi ve Google Analytics mülkündeki temel verilerle ilgili bir dizi faktörden etkilenir. Aşağıdaki faktörler daha yüksek maliyetlere neden olabilir:
- Satır sayısı: Daha fazla satır isteniyor.
- Boyut ve metrik sayısı: Daha fazla boyut ve metrik ekleme.
- Filtre karmaşıklığı: Karmaşık filtre ifadeleri kullanma.
- Tarih aralığı uzunluğu: Daha uzun tarih aralıklarında sorgu yürütme.
- Veri kardinalitesi: Yüksek kardinaliteli boyutlar (birçok benzersiz değer, örneğin
pagePath, özel boyutlar) jeton maliyetini önemli ölçüde artırabilir. - Mülk etkinlik hacmi: Daha yüksek etkinlik hacmine sahip mülklerdeki sorgular, daha az veriye sahip bir mülkteki aynı sorguya kıyasla daha fazla jeton kullanabilir.
Jeton kullanımını izleme
Belirli API çağrılarınızın jeton maliyetini belirlemenin en etkili yolu, istek gövdesine "returnPropertyQuota": true parametresini eklemektir.
API yanıtı, söz konusu istek tarafından kullanılan jetonları ve kalan kota bakiyelerini ayrıntılı olarak açıklayan PropertyQuota nesnesini içerir.