Method: properties.batchRunPivotReports

Toplu olarak birden fazla özet rapor döndürür. Tüm raporlar aynı Google Analytics mülküne ait 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 mülk kimliği. URL yolunda belirtilir, gövdede belirtilmez. Daha fazla bilgi için Mülk kimliğinizi nerede bulabileceğinizi öğrenin. Bu özellik, toplu işlem için belirtilmelidir. RunPivotReportRequest içindeki mülk belirtilmemiş olabilir veya bu mülkle tutarlı olabilir.

Örnek: properties/1234

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

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

object (RunPivotReportRequest)

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

Yanıt metni

Birden fazla pivot raporu 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ın ayrı bir pivot raporu 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

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 mülk kimliği. URL yolunda belirtilir, gövdede belirtilmez. Daha fazla bilgi için Mülk kimliğinizi nerede bulabileceğinizi öğrenin. Toplu istekte bu özellik belirtilmemiş olmalı veya toplu düzeydeki özellik ile tutarlı olmalıdır.

Örnek: properties/1234
dimensions[]

object (Dimension)

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

object (Metric)

İstenen metrikler. En az bir metrik belirtilmelidir. Tanımlanan tüm metrikler şunlardan biri tarafından kullanılmalıdır: metric_expression, metricFilter, orderBys.
dateRanges[]

object (DateRange)

Rapor için etkinlik verilerinin alınacağı tarih aralığı. Birden fazla tarih aralığı belirtilirse raporda her tarih aralığındaki etkinlik verileri kullanılır. Alan adı "dateRange" olan özel bir boyut, Pivot'un alan adlarına dahil edilebilir. Bu boyut dahil edilirse raporda tarih aralıkları karşılaştırılır. Bir grup isteğinde bu dateRanges belirtilmemelidir.
pivots[]

object (Pivot)

Raporun boyutlarının sütun veya satırlardaki görsel biçimini açıklar. Tüm pivotlardaki fieldNames (boyut adları) birleşimi, Boyutlar'da tanımlanan boyut adlarının bir alt kümesi olmalıdır. İki pivot aynı boyutu paylaşamaz. Bir boyut yalnızca pivotta görünüyorsa görünür.
dimensionFilter

object (FilterExpression)

Boyutların filtre ifadesi. Bu filtrede kullanılacak boyutlar istenmelidir. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre ifadesi. SQL having-clause'a benzer şekilde, toplama sonrası aşamasında uygulanır. Metriklerin bu filtrede kullanılmak üzere istenmesi gerekir. Bu filtrede boyutlar 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. İstek içinde bir grup varsa "grup" boyutu 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ğruysa bu satırlar, bir filtre tarafından ayrı olarak kaldırılmadıkları sürece döndürülür.

Bu keepEmptyRows ayarından bağımsız olarak, bir raporda yalnızca Google Analytics mülkü tarafından kaydedilen veriler görüntülenebilir.

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

boolean

Bu Google 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.
comparisons[]

object (Comparison)

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