Method: properties.runRealtimeReport

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

string

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 (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 koşulu. Bu filtrede metrikler kullanılamaz.

metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. SQL'in sahip tümcesine benzer şekilde, toplama sonrası aşamada uygulanır. Boyutlar bu filtrede kullanılamaz.

limit

string (int64 format)

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. limit pozitif olmalıdır.

Ayrıca, limit kadar 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 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 toplanması. Toplu metrik değerleri, boyutValues'un "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.

orderBys[]

object (OrderBy)

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

returnPropertyQuota

boolean

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 özelliğinde döndürülür.

minuteRanges[]

object (MinuteRange)

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 (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 sıralaması, satırlarda bulunan boyutlarla eşleşir.

metricHeaders[]

object (MetricHeader)

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

object (Row)

Rapordaki boyut değeri kombinasyonları ve metrik değerlerinin satırları.

totals[]

object (Row)

İstenirse metriklerin toplam değerleri.

maximums[]

object (Row)

İstenirse maksimum metrik değerleri.

minimums[]

object (Row)

İstenirse minimum metrik 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ğinde 50 satırdan limit tanesini içeriyorsa yanıt, 175 satırdan rowCount tanesini, ancak yalnızca 50 satırı içerecek.

propertyQuota

object (PropertyQuota)

Bu Analytics mülkünün istek dahil 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 dosyasındaki 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

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

string

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

startMinutesAgo

integer

Bugünden önceki dakika sayısı olarak sorgunun dahil başlangıç dakikası. Örneğin "startMinutesAgo": 29, raporun 29 dakika öncesine ve sonrasına ait etkinlik verilerini içermesi gerektiğini belirtir. endMinutesAgo tarihinden sonra olamaz.

Bir değer belirtilmediyse startMinutesAgo için varsayılan değer 29'dur. 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

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

Belirtilmemişse endMinutesAgo için varsayılan değer 0'dır. Standart Analytics mülkleri, etkinlik verilerinin son 30 dakikası içinde herhangi bir dakika (endMinutesAgo <= 29), 360 Analytics mülkleri ise son 60 dakika içindeki etkinlik verilerinin herhangi bir dakikasını (endMinutesAgo <= 59) isteyebilir.