Bu sayfa, Cloud Translation API ile çevrilmiştir.

Method: properties.runRealtimeReport

HTTP isteği
Yol parametreleri
İstek metni
- JSON gösterimi
Yanıt gövdesi
- JSON gösterimi
Yetkilendirme Kapsamları
Dakika Aralığı
- JSON gösterimi
Deneyin.

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, geçerli andan 30 dakika öncesine kadar (Google Analytics 360 mülkleri için en fazla 60 dakika) etkinlik ve kullanım verilerini gösterir.

Gerçek zamanlı istekler oluşturma ve yanıtları anlama rehberi 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, gTB Kod Geçişi söz dizimini kullanır.

Yol parametreleri

Parametreler

Parametreler
`property`	`string` Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. URL yolunda belirtilir, gövdede belirtilmez. Daha fazla bilgi edinmek için Mülk kimliğinizi bulma başlıklı makaleyi inceleyin. Örnek: mülkler/1234

property

string

Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. URL yolunda belirtilir, gövdede belirtilmez. Daha fazla bilgi edinmek için Mülk kimliğinizi bulma başlıklı makaleyi inceleyin.

Örnek: mülkler/1234

İstek metni

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

JSON gösterimi

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`) } ] }

{
  "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 boyutlar gösteriliyor.
`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 derlemesi adımına 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ı. Belirtilmemesi halinde 10.000 satır döndürülür. API, istediğiniz istek sayısı ne olursa olsun istek başına maksimum 100.000 satır döndürür. `limit` pozitif olmalıdır. `limit` kadar boyut boyutu yoksa API, istenen `limit` öğesinden daha az satır da 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şturduğunuzda `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,SizeValues'un "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
`orderBys[]`	`object (OrderBy)` Yanıtta satırların nasıl sıralanacağını belirtir.
`returnPropertyQuota`	`boolean` Bu Analytics Mülkü'nün Gerçek Zamanlı kotasının mevcut durumunu döndürüp döndürmeyeceğini belirler. Kota PropertyKotalar'ta 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ında sıfır tabanlı bir dakika aralığı dizini bulunur. İki dakikalık aralıklar çakışırsa çakışan dakikalarla ilgili etkinlik verileri, her iki dakika aralığının yanıt satırlarına dahil edilir.

Yanıt metni

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

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 }

{
  "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şir.
`metricHeaders[]`	`object (MetricHeader)` Metrik sütunlarını açıklar. MetricHeaders sayısı ve MetricHeaders sıralamaları, satırlardaki metriklerle eşleşir.
`rows[]`	`object (Row)` Rapordaki boyut değeri kombinasyonları ve metrik değeri 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 değerini içerirse yanıt, 175 üzerinden `rowCount` fakat 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 sabit dizedir "analyticsData#runRealtimeReport" JSON'deki 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ığı

Devam eden bir dakika kümesi: startMinutesAgo, startMinutesAgo + 1, ..., endMinutesAgo. İstekler en fazla 2 dakikalık aralıklara izin verir.

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

Alanlar

Alanlar
`name`	`string` Bu dakika aralığına bir ad atar. `dateRange` boyutu, rapor yanıtında bu ada sahip. Ayarlanmışsa `date_range_` veya `RESERVED_` ile başlayamaz. Ayarlanmazsa dakika aralıkları istekteki sıfır tabanlı diziniyle adlandırılır: `date_range_0`, `date_range_1` vb.
`startMinutesAgo`	`integer` Sorgunun kaç dakika önce başlayacağı dahil kapsayıcı başlangıç dakikası. Örneğin, `"startMinutesAgo": 29`, raporun 29 dakika ve sonrasına ait etkinlik verilerini içermesi gerektiğini belirtir. `endMinutesAgo` tarihinden sonra olamaz. Belirtilmezse `startMinutesAgo` varsayılan olarak 29 değerine ayarlanır. Standart Analytics mülkleri, son 30 dakikaya kadar etkinlik verilerini (`startMinutesAgo <= 29`) isteyebilir ve 360 Analytics mülkleri, son 60 dakikaya kadar etkinlik verilerini (`startMinutesAgo <= 59`) isteyebilir.
`endMinutesAgo`	`integer` Sorgunun kaç dakika önce gerçekleşeceğine dair bitiş tarihi. `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, etkinlik verilerinin son 30 dakika içindeki herhangi bir dakikasını (`endMinutesAgo <= 29`) ve 360 Analytics mülkleri, son 60 dakika içindeki etkinlik verilerini (`endMinutesAgo <= 59`) isteyebilir.

name

string

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

startMinutesAgo

integer

Sorgunun kaç dakika önce başlayacağı dahil kapsayıcı başlangıç dakikası. Örneğin, "startMinutesAgo": 29, raporun 29 dakika ve sonrasına ait etkinlik verilerini içermesi gerektiğini belirtir. endMinutesAgo tarihinden sonra olamaz.

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

endMinutesAgo

integer

Sorgunun kaç dakika önce gerçekleşeceğine dair bitiş tarihi. 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, etkinlik verilerinin son 30 dakika içindeki herhangi bir dakikasını (endMinutesAgo <= 29) ve 360 Analytics mülkleri, son 60 dakika içindeki etkinlik verilerini (endMinutesAgo <= 59) isteyebilir.