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 hesaplanır.
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. Anlık yöntemlere yapılan API istekleri, Anlık kotalarından düşülü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 jetonu sayısı | 40.000 | 400.000 |
| Saat Başına Mülk Başına Proje Başına Çekirdek Jetonları | 14.000 | 140.000 |
| Mülk Başına Eşzamanlı Temel İstek Sayısı | 10 | 50 |
| Proje başına, mülk başına, saatte temel sunucu hataları | 10 | 50 |
| Mülk başına günlük gerçek zamanlı jeton sayısı | 200.000 | 2.000.000 |
| Saat Başına Mülk Başına 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 saatlik 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 |
| Saat Başına Mülk Başına Proje Başına Dönüşüm Hunisi 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. Hata yanıtlarının tam listesi için Hata Yanıtları bölümüne bakın.
- 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üketse de 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. Bu faktörler maliyetlerin artmasına 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.