Google Analytics Realtime API, mülkünüz için gerçek zamanlı etkinlik verileriyle ilgili özelleştirilmiş bir rapor döndürür. Bu raporlar, son 30 dakika içindeki etkinlikleri ve kullanımları gösterir.
HTTP isteği
POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runRealtimeReport
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
property |
Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. Gövde metninde değil, URL yolunda belirtilir. Daha fazla bilgi için Mülk kimliğinizi nerede bulacağınızı öğrenin. Örnek: mülkleri/1234 |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi | |
---|---|
{ "dimensions": [ { object ( |
Alanlar | |
---|---|
dimensions[] |
İstenen ve görüntülenen boyutlar. |
metrics[] |
İstenen ve gösterilen metrikler. |
limit |
Döndürülecek satır sayısı. |
dimensionFilter |
Boyutların filtre ifadesi. Boyutların bu filtrede kullanılması istenmelidir. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metriklerin filtre ifadesi. SQL toplama yan tümcesine benzer şekilde, toplama sonrası aşamasında uygulanır. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz. |
metricAggregations[] |
Metriklerin toplamı. Toplu metrik değerleri,dimensionValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir. |
orderBys[] |
Yanıtta satırların nasıl sıralandığını belirtir. |
returnPropertyQuota |
Bu Analytics Mülkü'nün Gerçek Zamanlı kotasının mevcut durumunun döndürülüp döndürülmeyeceğini değiştirir. Kota, PropertyQuota içinde döndürülür. |
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
Bir isteğe karşılık gelen yanıt gerçek zamanlı rapor tablosu.
JSON gösterimi | |
---|---|
{ "dimensionHeaders": [ { object ( |
Alanlar | |
---|---|
dimensionHeaders[] |
Boyut sütunlarını açıklar. DimensionHeaders sayısı ve DimensionHeaders öğesinin sıralaması, satırlarda bulunan boyutlarla eşleşir. |
metricHeaders[] |
Metrik sütunlarını açıklar. MetricHeaders'ın sayısı ve MetricHeaders'ın sıralaması, satırlardaki metriklerle eşleşir. |
rows[] |
Rapordaki boyut değeri kombinasyonları ve metrik değerleri satırları. |
totals[] |
İstenirse metriklerin toplam değerleri. |
maximums[] |
İstenirse metriklerin maksimum değerleri. |
minimums[] |
İstenirse metriklerin minimum değerleri. |
rowCount |
Yanıtta döndürülen satır sayısından bağımsız olarak, sorgu sonucundaki toplam satır sayısı. Örneğin bir sorgu 175 satır döndürüyorsa ve API isteğine sınır = 50 içeriyorsa yanıt rowCount = 175 ancak yalnızca 50 satır içerir. |
propertyQuota |
Bu istek dahil olmak üzere bu Analytics Mülkü'nün gerçek zamanlı kota durumu. |
Yetkilendirme Kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics