Method: properties.batchRunReports

Bir grup içinde birden çok rapor 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 için Mülk kimliğinizi nerede bulacağınızı öğrenin. Grup için bu özellik belirtilmelidir. RunReportRequest içindeki özellik belirtilmemiş veya bu mülkle tutarlı olabilir.

Örnek: mülkleri/1234

İstek içeriği

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

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

object (RunReportRequest)

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

Yanıt gövdesi

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

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

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'deki yanıt türlerini birbirinden 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 için Mülk kimliğinizi nerede bulacağınızı öğrenin. Bir toplu istekte, bu özellik belirtilmemiş veya toplu düzeydeki özellikle tutarlı olmalıdır.

Örnek: mülkleri/1234
dimensions[]

object (Dimension)

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

object (Metric)

İstenen ve gösterilen metrikler.
dateRanges[]

object (DateRange)

Okunacak verilerin tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırı sıfır tabanlı bir tarih aralığı dizini içerir. İki tarih aralığı çakışırsa çakışan günlere ait etkinlik verileri her iki tarih aralığının yanıt satırlarına eklenir. 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 Filtreleriyle İlgili Temel Bilgiler başlıklı makaleyi inceleyin. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre ifadesi. SQL'in yan tümcesine benzer şekilde, raporun 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ıdır. İlk satır, 0. satır olarak sayılır.

Sayfalara ayırma sırasında, ilk istek ofseti belirtmez veya eşdeğer olarak ofseti 0 değerine ayarlar; ilk istek satırların ilk limit değerini döndürür. İkinci istek, ofseti ilk isteğin limit değerine ayarlar; ikinci istek, satırların ikinci limit değerini döndürür.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın.
limit

string (int64 format)

Döndürülecek satır sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 250.000 satır döndürür. limit pozitif olmalıdır.

Ayrıca, limit kadar çok boyut değeri yoksa API, istenen limit satırdan 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.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın.
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.
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 kohort grubu. İstekte bir kohort grubu varsa "kohort" boyutu bulunmalıdır.
keepEmptyRows

boolean

Yanlış veya belirtilmemişse tüm metriklerin 0'a eşit olduğu her bir satır döndürülmez. Doğru değerine ayarlanırsa bu satırlar bir filtre tarafından ayrı olarak kaldırılmazsa döndürülür.

Bu keepEmptyRows ayarından bağımsız olarak, raporlarda yalnızca Google Analytics (GA4) mülkü tarafından kaydedilen veriler gösterilebilir.

Örneğin, bir mülk hiçbir zaman bir purchase etkinliğini günlüğe kaydetmemişse eventName boyutu ve eventCount metriği için yapılan sorguda eventName adlı satır bulunmaz: "purchase" ve eventCount: 0.
returnPropertyQuota

boolean

Bu Analytics Mülkü'nün 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.