Method: properties.batchRunPivotReports

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Birden fazla pivot raporu toplu olarak döndürür. Tüm raporlar aynı GA4 mülküne ait olmalıdır.

HTTP isteği

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

URL, gTB Kod Geçişi söz dizimini kullanır.

Yol parametreleri

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. Bu özellik grup için belirtilmelidir. RunPivotReportRequest'taki mülk belirtilmemiş veya bu mülkle tutarlı olabilir.

Örnek: mülkler/1234

İstek metni

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

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

object (RunPivotReportRequest)

Talepler. Her isteğin ayrı bir pivot rapor yanıtı vardır. Her 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 fazla 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 sabit dizedir "analyticsData#batchRunPivotreports" 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

PivotReport İsteği Çalıştır

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ı. URL yolunda belirtilir, gövdede belirtilmez. Daha fazla bilgi edinmek için Mülk kimliğinizi bulma başlıklı makaleyi inceleyin. Bir toplu istekte bu özellik belirtilmemiş veya toplu düzey mülkle 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: SizeExpression, SizeFiltre, pivotlar, orderBys.

metrics[]

object (Metric)

İstenen metrikler. En az bir metriğin belirtilmesi gerekir. Tanımlanan tüm metrikler aşağıdakilerden biri tarafından kullanılmalıdır: metrik_ifadesi, metrikFiltre, orderBys.

dateRanges[]

object (DateRange)

Raporla ilgili etkinlik verilerinin alınacağı tarih aralığı. Birden fazla tarih aralığı belirtilirse her tarih aralığındaki etkinlik verileri raporda kullanılır. 's alan adı alanında özel bir boyuta sahip bir alan adı kullanılabilir; dahil edilmesi durumunda rapor, tarih aralıkları arasında karşılaştırma yapar. Kohort isteğinde bu dateRanges belirtilmemelidir.

pivots[]

object (Pivot)

Rapor boyutlarının sütunlarda veya satırlarda 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. İki pivot, bir boyutu paylaşamaz. Boyut, yalnızca bir pivot alanında yer alıyorsa görünür.

dimensionFilter

object (FilterExpression)

Boyutların filtre koşulu. Boyutların bu filtrede kullanılması için istekte bulunulması gerekir. 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. Metriklerin bu filtrede kullanılması için istekte bulunulması gerekir. Boyutlar bu filtrede kullanılamaz.

currencyCode

string

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

cohortSpec

object (CohortSpec)

Bu istekle ilişkili grup. İstekte kohort grubu varsa 'kohort' boyut bulunmalıdır.

keepEmptyRows

boolean

Yanlışsa veya belirtilmemişse tüm metrikleri 0'a eşit olan her 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.

returnPropertyQuota

boolean

Bu Analytics Mülkü kotasının mevcut durumunu döndürüp döndürmeyeceğini belirler. Kota PropertyKotalar'ta döndürülür.