Method: properties.runRealtimeReport

Mülkünüz için gerçek zamanlı etkinlik verileriyle ilgili özelleştirilmiş bir rapor döndürür. Etkinlikler, Google Analytics'e gönderildikten 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) zaman aralıklarına ait etkinlikleri ve kullanım verilerini gösterir.

Gerçek zamanlı istekler oluşturma ve yanıtları anlama ile ilgili kılavuz için Gerçek Zamanlı Rapor Oluşturma başlıklı makaleyi inceleyin.

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 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 (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österilen metrikler.
dimensionFilter

object (FilterExpression)

Boyutların filtre ifadesi. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre ifadesi. SQL toplama yan tümcesine benzer şekilde, toplama sonrası aşamasında uygulanır. Boyutlar bu filtrede kullanılamaz.
limit

string (int64 format)

Döndürülecek satır sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 250.000 satır döndürür. limit pozitif olmalıdır.

Ayrıca, limit kadar çok boyut değeri yoksa API, istenen limit satırdan 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 hakkında 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 toplamı. Toplu metrik değerleri,dimensionValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
orderBys[]

object (OrderBy)

Yanıtta satırların nasıl sıralandığını belirtir.
returnPropertyQuota

boolean

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.
minuteRanges[]

object (MinuteRange)

Okunacak etkinlik verilerinin dakika aralıkları. Belirtilmemişse son 30 dakika için bir dakika aralığı kullanılır. Birden fazla dakika aralığı istenirse her yanıt satırı sıfır tabanlı bir dakika aralığı dizini içerir. İki dakika aralıkları çakışırsa çakışan dakikalara ait etkinlik verileri her iki dakika aralığının yanıt satırlarına eklenir.

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 (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. DimensionHeaders sayısı ve DimensionHeaders öğesinin sıralaması, satırlarda bulunan boyutlarla eşleşir.
metricHeaders[]

object (MetricHeader)

Metrik sütunlarını açıklar. MetricHeaders'ın sayısı ve MetricHeaders'ın sıralaması, satırlardaki metriklerle eşleşir.
rows[]

object (Row)

Rapordaki boyut değeri 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üyorsa ve API isteğine limit/50 satırı dahil ediyorsa yanıt, 175 satırdan rowCount tanesini ancak 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'deki yanıt türlerini birbirinden 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

MinuteRange

Bitişik dakika grubu: startMinutesAgo, startMinutesAgo + 1, ..., endMinutesAgo. İstekler için en fazla 2 dakikalık aralıklara izin verilir.

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

string

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

integer

Şu ana kadarki dakika sayısı şeklinde sorgu için dahil başlangıç dakikası. Örneğin "startMinutesAgo": 29, raporun 29 dakika önceki ve sonrasına ait etkinlik verilerini içermesi gerektiğini belirtir. endMinutesAgo tarihinden sonra olamaz.

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

integer

Şu ana kadarki dakika sayısı olarak sorgunun dahil olduğu bitiş dakikası. startMinutesAgo tarihinden önce olamaz. Örneğin "endMinutesAgo": 15, raporun 15 dakika öncesine ait etkinlik verilerini içermesi gerektiğini belirtir.

Bir değer belirtilmezse endMinutesAgo varsayılan olarak 0 değerine ayarlanır. Standart Analytics mülkleri, son 30 dakikalık etkinlik verilerindeki (endMinutesAgo <= 29) herhangi bir dakika için istekte bulunabilir. 360 Analytics mülkleri ise son 60 dakika içindeki etkinlik verilerinin herhangi bir dakikasını (endMinutesAgo <= 59) isteyebilir.