Method: properties.batchRunPivotReports

Bir toplu işlemde birden çok pivot 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/*}: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 edinmek için Mülk Kimliğinizi nerede bulabileceğinizi öğrenin. Grup için bu özellik belirtilmelidir. RunPivotRaporRequest içindeki özellik belirtilmemiş veya bu özellikle tutarlı olabilir.

Örnek: mülkler/1234

İstek içeriği

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

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

object (RunPivotReportRequest)

Bağımsız 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 gövdesi

Birden fazla 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)

Bireysel yanıtlar. Her yanıt için 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 dosyasındaki 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

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,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
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 edinmek için Mülk Kimliğinizi nerede bulabileceğinizi öğrenin. Toplu istek içinde, bu özelliğin belirtilmemiş olması veya grup düzeyindeki özellikle tutarlı olması gerekir.

Örnek: mülkler/1234

dimensions[]

object (Dimension)

İstenen boyutlar. Tanımlanmış tüm boyutlar, şunlardan biri tarafından kullanılmalıdır: dimensionExpression,dimensionFilter, pivots, orderBys.

metrics[]

object (Metric)

İstenen metrikler, en az bir metriğin belirtilmesi gerekiyor. Tanımlanan tüm metrikler şunlardan biri tarafından kullanılmalıdır: metric_expression, metricFilter, orderBys.

dateRanges[]

object (DateRange)

Rapordaki etkinlik verilerinin alınacağı tarih aralığı. Birden çok tarih aralığı belirtilirse raporda her bir tarih aralığına ait etkinlik verileri kullanılır. Alan adı "dateRange" olan özel bir boyut Özet'in alan adlarına dahil edilebilir; varsa rapor, tarih aralıkları arasında karşılaştırma yapar. Bir kohort isteğinde bu dateRanges belirtilmemelidir.

pivots[]

object (Pivot)

Rapordaki boyutların görsel biçimini sütun veya satırlar halinde açıklar. Tüm özetlerdeki FieldNames toplamı (boyut adları), Boyutlar'da tanımlanan boyut adlarının bir alt kümesi olmalıdır. Hiçbir özet bir boyutu paylaşamaz. Bir boyut yalnızca özette yer alıyorsa görünür.

dimensionFilter

object (FilterExpression)

Boyutların filtre koşulu. Boyutların bu filtrede kullanılmaları için istenmesi gerekir. Bu filtrede metrikler kullanılamaz.

metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. SQL'in sahip tümcesine benzer şekilde, toplama sonrası aşamada uygulanır. Metriklerin bu filtrede kullanılmaları için istenmesi gerekir. Boyutlar bu filtrede kullanılamaz.

currencyCode

string

ISO4217 biçiminde, "AED", "USD", "JPY" gibi 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. "Kohort" isteğinde bir kohort grubu varsa boyutu bulunmalıdır.

keepEmptyRows

boolean

Yanlış veya belirtilmediyse 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ıca kaldırılmadıklarında 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 purchase etkinliği günlüğe kaydetmediyse eventName boyutu ve eventCount metriği için sorguda eventName: "purchase" satırı bulunmaz. ve eventCount: 0.

returnPropertyQuota

boolean

Bu Analytics Mülküne ait kotanın mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, PropertyQuota özelliğinde döndürülür.

comparisons[]

object (Comparison)

İsteğe bağlı. İstenen ve görüntülenen karşılaştırmaların yapılandırması. İstekte karşılaştırma sütunu alabilmek için hem karşılaştırmalar alanı hem de karşılaştırmalar boyutu gerekir.