Method: properties.batchRunPivotReports

Birden fazla pivot 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/*}:batchRunPivotReports

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. RunPivotReportRequest 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 (RunPivotReportRequest)
    }
  ]
}
Alanlar
requests[]

object (RunPivotReportRequest)

Ayrı istekler. Her isteğin ayrı bir pivot raporu 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 pivot rapor içeren toplu yanıt.

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

object (RunPivotReportResponse)

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

string

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

PivotReportRequest'i çalıştır

Pivot raporu oluşturma isteği.

JSON gösterimi 
{
  "property": string,
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "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 boyutlar. Tanımlanan tüm boyutlar şunlardan biri tarafından kullanılmalıdır: BoyutExpression, BoyutFiltre, pivotlar, orderBys.
metrics[]

object (Metric)

İstenen metrikler, en az bir metriğin belirtilmesi gerekir. Tanımlanan tüm metrikler şunlardan biri tarafından kullanılmalıdır: metrik_ifadesi, metrikFiltre, orderBys.
dateRanges[]

object (DateRange)

Rapor için etkinlik verilerinin alınacağı tarih aralığı. Birden fazla tarih aralığı belirtilirse her bir tarih aralığındaki etkinlik verileri raporda kullanılır. Bir Pivot alanında, alan adına "dateRange" adlı özel bir boyut eklenebilir. Rapor dahil edilirse rapor, tarih aralıkları arasında karşılaştırma yapar. Bir grup isteğinde bu dateRanges belirtilmemelidir.
pivots[]

object (Pivot)

Rapor boyutlarının sütunlar veya satırlardaki görsel biçimini açıklar. Tüm pivotlardaki alan adlarının (boyut adları) birleşimi, Boyutlar'da tanımlanan boyut adlarının bir alt kümesi olmalıdır. Hiçbir iki pivot grup bir boyutu paylaşamaz. Boyut, yalnızca bir pivot tabloda yer alıyorsa görünür.
dimensionFilter

object (FilterExpression)

Boyutların filtre koşulu. Boyutların bu filtrede kullanılması istenmelidir. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. SQL'in sahip olduğu içeriğe benzer şekilde, toplama sonrası aşamada uygulanır. Metriklerin bu filtrede kullanılması için istekte bulunulması gerekir. Boyutlar bu filtrede kullanılamaz.
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.