Method: properties.batchRunPivotReports

Birden çok 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övdede değil, URL yolunda belirtilir. Daha fazla bilgi için Mülk Kimliğinizi nerede bulabileceğinize bakın. Grup için bu özellik belirtilmelidir. RunPivotReportRequest içindeki özellik belirtilmemiş veya bu mülkle tutarlı olabilir.

Örnek: mülkler/1234

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

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

object (RunPivotReportRequest)

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

Yanıt gövdesi

Birden çok pivot 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
{
  "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'deki yanıt türlerini ayırt etmek için yararlı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

RunPivotReportRequest

Pivot rapor 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övdede değil, URL yolunda belirtilir. Daha fazla bilgi için Mülk Kimliğinizi nerede bulabileceğinize bakın. Toplu istekte, bu özellik belirtilmemiş veya toplu düzeyindeki özellikle 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, boyutFiltresi, pivotlar, siparişBys.

metrics[]

object (Metric)

İstenen metrikler. En az bir metrik belirtilmelidir. Tanımlanan tüm metrikler şunlardan biri tarafından kullanılmalıdır: metrik_ifadesi, metrikFiltresi, siparişBys.

dateRanges[]

object (DateRange)

Rapor için etkinlik verilerinin alınacağı tarih aralığı. Birden fazla tarih aralığı belirtilirse raporda her bir tarih aralığındaki etkinlik verileri kullanılır. "dateRange" alan adına sahip özel bir boyut, Pivot Pivot'un alan adlarına dahil edilebilir. Eklenmesi durumunda, rapor tarih aralıkları arasında karşılaştırma yapar. Grup isteğinde bu dateRanges belirtilmemiş olmalıdır.

pivots[]

object (Pivot)

Rapor boyutlarının sütun veya satırlarda görsel biçimini açıklar. Tüm pivotlardaki fieldName'lerin (boyut adları) birleşimi, Boyutlar'da tanımlanan boyut adlarının bir alt kümesi olmalıdır. Hiçbir pivot tablo bir boyutu paylaşamaz. Bir boyut yalnızca bir özette yer alıyorsa görünü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'in yan tümcesine benzer şekilde toplama sonrası aşamasında uygulanır. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz.

currencyCode

string

"AED", "USD", "JPY" gibi ISO4217 biçimindeki bir para birimi kodu. Alan boşsa raporda mülkün varsayılan para birimi kullanılır.

cohortSpec

object (CohortSpec)

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

keepEmptyRows

boolean

Yanlış değerine ayarlanırsa veya belirtilmemişse tüm metriklerin 0'a eşit olduğu her satır döndürülmez. True (doğru) değerine ayarlanırsa bu satırlar bir filtre tarafından ayrıca kaldırılmazsa 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österilebilir.

Örneğin, bir mülk hiçbir zaman purchase etkinliğini günlüğe kaydetmezse eventName boyutu ve eventCount metriği için yapılan sorguda eventName 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 belirler. Kota, PropertyQuota içinde döndürülür.