Bu belgede, yalnızca Analytics 360 müşterilerinin kullanabildiği Google Analytics Reporting API v4 için Kaynak Tabanlı Kota sistemi açıklanmaktadır. API'lere uygulanan sınırların tamamı için API Sınırları ve Kotaları'na bakın.
Giriş
Paylaşılan kaynakların kullanılabilirliğini ve güvenilirliğini sağlamak için Analytics Reporting API'ye erişen her proje sınırlara ve kotalara tabidir. Büyük veri kümelerini sorgularken Analytics Reporting API, örnekleme yöntemini kullanabilir ve bu da verilerinizin sonuçlarını etkileyebilir.
Kaynak tabanlı kota sistemi, Analytics Reporting API'yi kullanırken Analytics 360 hesaplarının daha yüksek örnekleme eşiklerine sahip olmasını sağlayacak yeni bir kota sistemidir. Bu sistem isteğe bağlıdır ve Google API Konsolu'nun kotalar sayfasında bildirilenler gibi görünümler ve projeler için belirlenen mevcut sınırlardan bağımsızdır.
Kaynak tabanlı kota
Tüm istekler eşit oluşturulmaz; bazı istekler işlemsel olarak diğerlerinden çok daha pahalıdır. Kaynak tabanlı kota sistemi, Analytics Raporlama altyapısını korurken daha yüksek bir örnekleme eşiğini destekleyecek şekilde tasarlanmıştır.
Her mülke belirli miktarda sorgu kaynağı jetonu ayrılır. API istemcisi, göreli sorgu kaynak jetonları karşılığında daha yüksek bir örnekleme eşiği almak için API isteğine isteğe bağlı bir alan ekleyebilir. Hesaplama açısından daha pahalı olan bir istek için daha fazla jeton gerekir.
Örnekleme eşiği
Google Analytics API v4 kullanılarak veri gönderilen istekler, istenen tarih aralığı için (mülk düzeyinde) oturum sayısına bağlı olarak, aşağıdaki genel örnekleme eşiklerine tabidir:
- Analytics Standart: 500 bin oturum
- Analytics 360: 1 milyon oturum
- Kaynak tabanlı kota kullanan Analytics 360: 100 milyon oturum
Kaynak Tabanlı Kotayı Etkinleştir
Belirli bir istekte kaynak tabanlı kotaları etkinleştirmek için API çağrısı, batchGet
yönteminde isteğe bağlı useResourceQuotas
alanını içermelidir.
{
"reportRequests": [{object(ReportRequest)}],
"useResourceQuotas": boolean,
}
Örneğin:
{
"reportRequests":[
{
"viewId":"XXXX",
"dateRanges":[
{
"startDate":"2017-06-15",
"endDate":"2017-06-30"
}],
"metrics":[
{
"expression":"ga:sessions"
}],
"dimensions": [
{
"name":"ga:browser"
}]
}],
"useResourceQuotas": true
}
Sorgu kaynak maliyeti yanıt alanı
batchGet
yöntemine yapılan her çağrı için yanıtta bir queryCost
alanı olacaktır.
{
"reports": [{ object(Report) }],
"queryCost": number
}
queryCost
alanı, batchGet
isteğindeki tüm ReportRequests
öğelerinin toplam kaynak maliyetini temsil eden bir tam sayıdır.
Örneğin:
{
"reports": [
{
"columnHeader": {...},
"data": {
"rows": [...]
}
}
],
"queryCost": 1337
}
Kota ayırma
Analytics 360 mülk kotası
- Mülk başına günlük 100.000 sorgu maliyet birimi.
- Mülk başına saatlik 25.000 sorgu maliyet birimi.
Kota sınırınızı aşarsanız RESOURCE_EXHAUSTED
hatası alırsınız. Ayrıntılar için Hata Yanıtları bölümüne bakın.
Maliyet hesaplaması
Bir isteğin maliyeti aşağıdakilerle orantılıdır:
- Tarih aralığının boyutu.
- Görünümdeki isabet sayısı.
- İstenen boyutların kardinalitesi.
- İstenen boyut ve metriklerin sayısı.
- Segment ve filtre tanımlarının karmaşıklığı.
- İstenen bilgilerin işleme durumu (bugünün verilerini istemek, düne ait verileri istemekten daha maliyetlidir).
- Sorgu Zamanını içe aktarma boyutlarının ve metriklerinin varlığı.
API sınırları ve kullanımı
API'ler, kaynak tabanlı kota sisteminin yanı sıra Analytics API v4'teki sınırlara ve kotalara da tabidir.
Notlar
queryCost
yanıt alanı, bir isteğin işlem maliyetini gösterir. Parasal bir maliyet yoktur ve API'nin kullanımı ücretsizdir.- Gün içi ve bazı geçmiş veri (1 yıldan eski) raporlar,
useResourceQuotas
ayarından bağımsız olarak örneklemeye tabi olabilir. - Bir istek için daha yüksek bir örnekleme eşiği karşılanamazsa kaynak kota jetonları düşülmez (örneklenmiş yanıtların kaynak kotası her zaman sıfır maliyeti olur).
- Yanıtta
samplesReadCounts
,samplingSpaceSizes
alanları varsa rapor örneklenmiş veriler içerir.
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:
- Projeniz için faturalandırma hesabınız yoksa hesap oluşturun.
- API Konsolu'nda API kitaplığının Etkin API'ler sayfasını ziyaret edin ve listeden bir API seçin.
- 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.