Method: properties.batchRunReports

Birden fazla raporu toplu olarak döndürür. Tüm raporlar aynı GA4 Mülkü için olmalıdır.

HTTP isteği

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports

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 edinmek için Mülk Kimliğinizi nerede bulacağınızı öğrenin. Bu özellik grup için belirtilmelidir. RunReportRequest içindeki mülk belirtilmedi veya bu özellikle tutarlı olabilir.

Örnek: mülkler/1234

İstek metni

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

JSON gösterimi 
{
  "requests": [
    {
      object (RunReportRequest)
    }
  ]
}
Alanlar
requests[]

object (RunReportRequest)

Ayrı istekler. Her isteğin ayrı bir rapor yanıtı vardır. Her bir toplu isteğe en fazla 5 isteğe izin verilir.

Yanıt metni

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Birden çok rapor içeren toplu yanıt.

JSON gösterimi 
{
  "reports": [
    {
      object (RunReportResponse)
    }
  ],
  "kind": string
}
Alanlar
reports[]

object (RunReportResponse)

Tek tek yanıtlar. Her yanıtın ayrı bir rapor isteği vardır.
kind

string

Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu kind her zaman "analyticsData#batchRunReports" sabit dizesidir. JSON'daki 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

RunReportRequest

Rapor oluşturma isteği.

JSON gösterimi 
{
  "property": string,
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Alanlar
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 edinmek için Mülk Kimliğinizi nerede bulacağınızı öğrenin. Bir toplu işlem isteğinde bu özellik belirtilmemiş veya toplu düzey özelliğiyle tutarlı olmalıdır.

Örnek: mülkler/1234
dimensions[]

object (Dimension)

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

object (Metric)

İstenen ve görüntülenen metrikler.
dateRanges[]

object (DateRange)

Okunacak veri tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırında sıfır tabanlı bir tarih aralığı dizini bulunur. İki tarih aralığı çakışırsa, çakışan günlere ait etkinlik verileri her iki tarih aralığının yanıt satırlarına eklenir. Bir grup isteğinde bu dateRanges belirtilmemelidir.
dimensionFilter

object (FilterExpression)

Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek için Boyut Filtrelerinin Temelleri bölümünü inceleyin. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. SQL'in sahip olduğu içeriğe benzer şekilde, rapor satırları toplandıktan sonra uygulanır. Boyutlar bu filtrede kullanılamaz.
offset

string (int64 format)

Başlangıç satırının satır sayısı. İlk satır 0. satır olarak sayılır.

Sayfalara ayırma sırasında ilk istek, ofset belirtmiyor veya eşdeğer şekilde ofseti 0 olarak ayarlıyor; ilk istek satırların ilk limit tanesini döndürüyor. İkinci istek, ilk isteğin limit kadarı için ofset belirler. İkinci istek, ikinci satır limit değerini döndürür.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümünü inceleyin.
limit

string (int64 format)

Döndürülecek satırların sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. Kaç API isterseniz isteyin, API istek başına maksimum 250.000 satır döndürür. limit pozitif olmalıdır.

Ayrıca, limit kadar fazla 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 ile ilgili rapor oluştururken limit değerini daha yüksek bir değere ayarlasanız bile 300'den fazla satır alamazsınız.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümünü inceleyin.
metricAggregations[]

enum (MetricAggregation)

Metriklerin toplanması. Toplu metrik değerleri,SizeValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
orderBys[]

object (OrderBy)

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

string

"AED", "USD", "JPY" gibi ISO4217 biçiminde bir para birimi kodu. Alan boşsa rapor, mülkün varsayılan para birimini kullanır.
cohortSpec

object (CohortSpec)

Bu istekle ilişkili grup grubu. İstekte bir grup grubu varsa "kohort" boyutu bulunmalıdır.
keepEmptyRows

boolean

Yanlış ise veya belirtilmezse tüm metrikleri 0 olan her satır döndürülmez. True (Doğru) ise, bir filtre tarafından ayrı olarak kaldırılmazsa bu satırlar döndürülür.

Bu keepEmptyRows ayarından bağımsız olarak bir raporda yalnızca Google Analytics (GA4) mülkü tarafından kaydedilen veriler görüntülenebilir.

Örneğin, bir mülk hiçbir zaman purchase etkinliğini günlüğe kaydedmiyorsa eventName boyutu ve eventCount metriği için yapılan sorgu, satır eventName: "purchase" ve eventCount: 0 değerini içermez.
returnPropertyQuota

boolean

Bu Analytics Mülkünün kotasının geçerli durumunu döndürüp döndürmeyeceğini açar. Kota PropertyQuota içinde döndürülür.