Method: properties.runRealtimeReport

Mülkünüz için gerçek zamanlı etkinlik verilerinin özelleştirilmiş bir raporunu döndürür. Etkinlikler, Google Analytics'e gönderilmelerinden saniyeler sonra gerçek zamanlı raporlarda görünür. Gerçek zamanlı raporlar, içinde bulunulan andan 30 dakika öncesine kadar (Google Analytics 360 mülkleri için 60 dakikaya) kadar olan dönem için etkinlikleri ve kullanım verilerini gösterir.

Gerçek zamanlı istekler oluşturma ve yanıtları anlamayla ilgili kılavuz için Gerçek Zamanlı 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

string

Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. Gövde metninde değil, URL yolunda belirtilir. Daha fazla bilgi edinmek için Mülk Kimliğinizi nerede bulacağınızı öğrenin.

Örnek: mülkler/1234

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "returnPropertyQuota": boolean,
  "minuteRanges": [
    {
      object (MinuteRange)
    }
  ]
}
Alanlar
dimensions[]

object (Dimension)

İstenen ve görüntülenen boyutlar.
metrics[]

object (Metric)

İstenen ve görüntülenen metrikler.
dimensionFilter

object (FilterExpression)

Boyutların filtre koşulu. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. SQL'in sahip olduğu içeriğe benzer şekilde, toplama sonrası aşamada uygulanır. Boyutlar bu filtrede kullanılamaz.
limit

string (int64 format)

Döndürülecek satırların sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. Kaç API isterseniz isteyin, API istek başına maksimum 250.000 satır döndürür. limit pozitif olmalıdır.

Ayrıca, limit kadar fazla boyut değeri yoksa API, istenen limit değerinden daha az satır döndürebilir. Örneğin, country boyutu için 300'den az olası değer vardır. Bu nedenle, yalnızca country ile ilgili rapor oluştururken limit değerini daha yüksek bir değere ayarlasanız bile 300'den fazla satır alamazsınız.
metricAggregations[]

enum (MetricAggregation)

Metriklerin toplanması. Toplu metrik değerleri,SizeValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
orderBys[]

object (OrderBy)

Satırların yanıtta nasıl sıralanacağını belirtir.
returnPropertyQuota

boolean

Bu Analytics Mülkü'nün Gerçek Zamanlı kotasının geçerli durumunu döndürüp döndürmeyeceğini açar. Kota PropertyQuota içinde döndürülür.
minuteRanges[]

object (MinuteRange)

Okunacak etkinlik verilerinin dakika aralıkları. Belirtilmemesi halinde 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 ilişkin etkinlik verileri her iki dakika aralığı için yanıt satırlarına eklenir.

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 (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "totals": [
    {
      object (Row)
    }
  ],
  "maximums": [
    {
      object (Row)
    }
  ],
  "minimums": [
    {
      object (Row)
    }
  ],
  "rowCount": integer,
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Alanlar
dimensionHeaders[]

object (DimensionHeader)

Boyut sütunlarını açıklar. Boyut Başlıklarının sayısı ve Boyut Başlıklarının sıralaması, satırlarda bulunan boyutlarla eşleşiyor.
metricHeaders[]

object (MetricHeader)

Metrik sütunlarını açıklar. Metrik Başlıklarının sayısı ve Metrik Başlıklarının sıralaması, satırlarda bulunan metriklerle eşleşiyor.
rows[]

object (Row)

Rapordaki boyut-değer kombinasyonları ve metrik değerleri satırları.
totals[]

object (Row)

İstenirse metriklerin toplam değerleri.
maximums[]

object (Row)

İstenirse metriklerin maksimum değerleri.
minimums[]

object (Row)

İstenirse metriklerin minimum değerleri.
rowCount

integer

Sorgu sonucundaki toplam satır sayısı. rowCount, yanıtta döndürülen satır sayısından ve limit istek parametresinden bağımsızdır. Örneğin, bir sorgu 175 satır döndürürse ve API isteğinde limit/50 içeriyorsa yanıt, 175 satırdan rowCount tanesini içerir, ancak yalnızca 50 satır içerir.
propertyQuota

object (PropertyQuota)

Bu istek dahil olmak üzere bu Analytics mülkünün gerçek zamanlı kota durumu.
kind

string

Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu kind her zaman "analyticsData#runrealtimeReport" sabit dizesidir. JSON'daki yanıt türlerini ayırt etmek için kullanışlıdır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

Dakika Aralığı

Bitişik bir dakika kümesi: startMinutesAgo, startMinutesAgo + 1, ..., endMinutesAgo. İstekler 2 dakikaya kadar sürebilir.

JSON gösterimi 
{
  "name": string,
  "startMinutesAgo": integer,
  "endMinutesAgo": integer
}
Alanlar
name

string

Bu dakika aralığına bir ad atar. dateRange boyutu, rapor yanıtında bu adın değerine ayarlanır. Ayarlanırsa date_range_ veya RESERVED_ ile başlayamaz. Ayarlanmazsa dakika aralıkları istekte istek temeline göre sıfır tabanlı diziniyle adlandırılır: date_range_0, date_range_1 vb.
startMinutesAgo

integer

Sorgunun, bundan önceki dakika cinsinden kapsayıcı başlangıç dakikası. Örneğin "startMinutesAgo": 29, raporun 29 dakika öncesindeki ve sonrasındaki etkinlik verilerini içermesi gerektiğini belirtir. endMinutesAgo tarihinden sonra olamaz.

Belirtilmemesi halinde startMinutesAgo varsayılan olarak 29 değerine ayarlanır. Standart Analytics mülkleri, son 30 dakikaya kadar etkinlik verilerini (startMinutesAgo <= 29) isteyebilir. 360 Analytics mülkleri ise son 60 dakikaya kadar etkinlik verilerini (startMinutesAgo <= 59) isteyebilir.
endMinutesAgo

integer

Sorgunun, bundan önceki dakika cinsinden kapsayıcı bitiş dakikasıdır. startMinutesAgo tarihinden önce olamaz. Örneğin "endMinutesAgo": 15, raporun 15 dakika öncesine ait etkinlik verilerini içermesi gerektiğini belirtir.

Belirtilmemesi halinde endMinutesAgo varsayılan olarak 0 olur. Standart Analytics mülkleri, etkinlik verilerinin son 30 dakikasına (endMinutesAgo <= 29) ve 360 Analytics mülklerine, etkinlik verilerinin son 60 dakika içindeki (endMinutesAgo <= 59) herhangi bir dakika için istekte bulunabilir.