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 raporlar, son 30 dakika içindeki etkinlikleri ve kullanımları gösterir.

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ö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)
    }
  ],
  "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, kaç tane istediğinize bakılmaksızın istek başına maksimum 100.000 satır döndürür.
dimensionFilter

object (FilterExpression)

Boyutların filtre ifadesi. Boyutların bu filtrede kullanılması istenmelidir. 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. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz.
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.

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 öğ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

Yanıtta döndürülen satır sayısından bağımsız olarak, sorgu sonucundaki toplam satır sayısı. Örneğin bir sorgu 175 satır döndürüyorsa ve API isteğine sınır = 50 içeriyorsa yanıt rowCount = 175 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.

Yetkilendirme Kapsamları

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

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