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 hesaplanır.

Kota kategorileri

Data API'nin dört istek kotası kategorisi vardır: Core, Realtime, Funnel ve Chat.

Temel yöntemlere yapılan API istekleri için temel kotalar uygulanır. Realtime yöntemlerine yapılan API istekleri, Realtime kotalarından düşülür. Dönüşüm hunisi yöntemlerine yapılan API istekleri, dönüşüm hunisi kotalarından düşülür. Chat yöntemlerine yapılan API istekleri, Chat 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
Sohbet properties.chat

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
Saat Başına Mülk Başına Proje Başına Gerçek Zamanlı Jeton Sayısı 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
Mülk Başına Günlük Sohbet Jetonu 3.750.000 3.750.000
Saat Başına Tesis Başına Sohbet Jetonları 500.000 500.000
  • 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 Sayısı" hem de "Proje Başına Mülk Başına Saatlik Jeton Sayısı" 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.

Özelliklerin 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 için 10 veya daha az jeton alınsa da daha karmaşık istekler (ör. Analytics Asistanı chat sorguları) daha fazla jeton tüketir.

Jeton tüketimini etkileyen faktörler

Bir isteğin tam jeton maliyeti, yürütme sırasında belirlendiğinden ö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 (pagePath gibi birçok benzersiz değer, ö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.

Sohbet jetonu tüketimi ve izleme

Analytics Danışmanı chat isteklerinde jetonlar, model hesaplama, muhakeme ve temel verileri alma maliyetlerini temsil eder. Sohbet jetonu tüketimi şunlardan etkilenir:

  • Sorgu ve analiz kapsamı: İstenen analizin karmaşıklığı ve kapsamı.
  • Model giriş ve çıkış jetonları: İşlenen bağlamsal veri hacmi ve oluşturulan yanıt anlatısı.
  • Düşünme jetonları: Bulguları sentezlemek için gereken model muhakeme adımları.
  • Yürütme gecikmesi: Çok adımlı veri keşifleri için gereken işleme süresi.

Sohbet jetonu kullanımını izlemek için "returnPropertyQuota": true ChatRequest içinde ayarlayın. Yanıt, kullanılan ve kalan bakiyeleri içeren tokensPerDay ve tokensPerHour alanlarını içeren PropertyChatQuota nesnesini içerir.