- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- MinuteRange
- Deneyin.
Mülkünüzün gerçek zamanlı etkinlik verilerinden özelleştirilmiş bir rapor döndürür. Etkinlikler, Google Analytics'e gönderildikten saniyeler sonra gerçek zamanlı raporlarda görünür. Anlık raporlar, o an ile 30 dakika öncesi (Google Analytics 360 mülkleri için en fazla 60 dakika) arasındaki zaman dilimlerine ait etkinlikleri ve kullanım verilerini gösterir.
Gerçek zamanlı istek oluşturma rehberi için Anlık Rapor Oluşturma bölümüne bakın.
HTTP isteği
POST https://analyticsdata.googleapis.com/v1beta/{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övdede değil, URL yolunda belirtilir. Daha fazla bilgi edinmek için Mülk Kimliğinizi nerede bulabileceğinizi öğrenin. Örnek: mülkler/1234 |
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "dimensions": [ { object ( |
Alanlar | |
---|---|
dimensions[] |
İstenen ve görüntülenen boyutlar. |
metrics[] |
İstenen ve gösterilen metrikler. |
dimensionFilter |
Boyutların filtre koşulu. Bu filtrede metrikler kullanılamaz. |
metricFilter |
Metriklerin filtre koşulu. SQL'in sahip tümcesine benzer şekilde, toplama sonrası aşamada uygulanır. Boyutlar bu filtrede kullanılamaz. |
limit |
Döndürülecek satır sayısı. Belirtilmezse 10.000 satır döndürülür. API, istediğiniz sayıda satırdan bağımsız olarak istek başına en fazla 250.000 satır döndürür. Ayrıca, |
metricAggregations[] |
Metriklerin toplanması. Toplu metrik değerleri, boyutValues'un "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir. |
orderBys[] |
Satırların yanıtta nasıl sıralandığını belirtir. |
returnPropertyQuota |
Bu Analytics mülkünün Gerçek zamanlı kotasının geçerli durumunun döndürülüp döndürülmeyeceğini belirler. Kota, PropertyQuota bölümünde döndürülür. |
minuteRanges[] |
Okunacak etkinlik verilerinin dakika aralıkları. Belirtilmemişse son 30 dakika için bir dakikalık aralık kullanılır. Birden fazla dakika aralığı istenirse her yanıt satırı sıfır tabanlı bir dakika aralığı dizini içerir. İki dakikalık aralıklar çakışırsa çakışan dakikalara ait etkinlik verileri her iki dakika aralığının yanıt satırlarına dahil edilir. |
Yanıt gövdesi
Bir isteğe karşılık gelen yanıt gerçek zamanlı rapor tablosu.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "dimensionHeaders": [ { object ( |
Alanlar | |
---|---|
dimensionHeaders[] |
Boyut sütunlarını açıklar. DimensionHeaders sayısı ve DimensionHeaders sıralaması, satırlarda bulunan boyutlarla eşleşir. |
metricHeaders[] |
Metrik sütunlarını açıklar. MetricHeaders'ların sayısı ve MetricHeaders'ların sıralaması, satırlarda bulunan metriklerle eşleşir. |
rows[] |
Rapordaki boyut değeri kombinasyonları ve metrik değerlerinin satırları. |
totals[] |
İstenirse metriklerin toplam değerleri. |
maximums[] |
İstenirse maksimum metrik değerleri. |
minimums[] |
İstenirse minimum metrik değerleri. |
rowCount |
Sorgu sonucundaki toplam satır sayısı. |
propertyQuota |
Bu Analytics mülkünün istek dahil gerçek zamanlı kota durumu. |
kind |
Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
MinuteRange
Kesintisiz dakika grubu: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. İsteklere en fazla 2 dakikalık aralıklarla izin verilir.
JSON gösterimi |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
Alanlar | |
---|---|
name |
Bu dakika aralığına bir ad atar. |
startMinutesAgo |
Bugünden önceki dakika sayısı olarak sorgunun dahil başlangıç dakikası. Örneğin Bir değer belirtilmediyse |
endMinutesAgo |
Bugünden önceki dakika sayısı olarak sorgunun dahil bitiş dakikası. Belirtilmemişse |