Method: properties.runRealtimeReport

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 raporlarda son 30 dakika içindeki etkinlikler ve kullanımlar gösterilir.

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

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)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "returnPropertyQuota": boolean
}
Alanlar
dimensions[]

object (Dimension)

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

object (Metric)

İstenen ve gösterilen metrikler.
limit

string (int64 format)

Döndürülecek satır sayısı. limit parametresi 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 100.000 satır döndürür.
dimensionFilter

object (FilterExpression)

Boyutların filtre koşulu. Boyutların bu filtrede kullanılmaları için istenmesi gerekir. 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. Metriklerin bu filtrede kullanılmaları için istenmesi gerekir. Boyutlar bu filtrede kullanılamaz.
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 bölümünde 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 (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "totals": [
    {
      object (Row)
    }
  ],
  "maximums": [
    {
      object (Row)
    }
  ],
  "minimums": [
    {
      object (Row)
    }
  ],
  "rowCount": integer,
  "propertyQuota": {
    object (PropertyQuota)
  }
}
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

Yanıtta döndürülen satırların sayısından bağımsız olarak, sorgu sonucundaki toplam satır sayısı. Örneğin, bir sorgu 175 satır döndürür ve API isteğinde limit = 50 değerini içeriyorsa yanıt, lineCount = 175 ancak yalnızca 50 satır içerir.
propertyQuota

object (PropertyQuota)

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