Method: properties.batchRunPivotReports

Bir grupta birden fazla özet rapor döndürür. Tüm raporlar aynı Google Analytics 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 mülkü kimliği. Gövdede değil, URL yolunda belirtilir. Daha fazla bilgi için mülk kimliğinizi nerede bulabileceğinize bakın. Bu özellik, toplu işlem için belirtilmelidir. RunPivotReportRequest içindeki mülk belirtilmemiş veya bu mülkle tutarlı olabilir.

Örnek: mülkler/1234

İstek içeriği

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

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

object (RunPivotReportRequest)

Ayrı ayrı istekler. Her istek için ayrı bir pivot rapor yanıtı vardır. Her toplu istek için en fazla 5 istek gönderilebilir.

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ı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 "analyticsData#batchRunPivotReports" 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. Gövdede değil, URL yolunda belirtilir. Daha fazla bilgi için mülk kimliğinizi nerede bulabileceğinize bakın. Bu özellik, toplu istek içinde belirtilmemiş veya toplu düzeydeki mülkle tutarlı olmalıdır.

Örnek: mülkler/1234
dimensions[]

object (Dimension)

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

object (Metric)

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

object (DateRange)

Raporun etkinlik verilerinin alınacağı tarih aralığı. Birden fazla tarih aralığı belirtilirse raporda her tarih aralığındaki etkinlik verileri kullanılır. "dateRange" alan adına sahip özel bir boyut, pivot tablonun alan adlarına dahil edilebilir. Bu boyut dahil edildiğinde rapor, tarih aralıklarını karşılaştırır. Bir kohort isteğinde bu dateRanges belirtilmemelidir.
pivots[]

object (Pivot)

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

object (FilterExpression)

Boyutların filtre ifadesi. Boyutların bu filtrede kullanılması için istenmesi gerekir. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre ifadesi. SQL having-clause'a benzer şekilde, toplama sonrası aşamada uygulanır. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz.
currencyCode

string

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

object (CohortSpec)

Bu istekle ilişkili kohort grubu. İstekte bir kohort grubu varsa "kohort" boyutu mevcut olmalıdır.
keepEmptyRows

boolean

Yanlış veya belirtilmemişse tüm metrikleri 0 olan her satır döndürülmez. Doğru ise bir filtre tarafından ayrı olarak kaldırılmazlarsa bu satırlar döndürülür.

Bu keepEmptyRows ayarından bağımsız olarak, raporlarda yalnızca Google Analytics mülkü tarafından kaydedilen veriler gösterilebilir.

Örneğin, bir mülk hiçbir zaman purchase etkinliği günlüğe kaydetmezse eventName boyutu ve eventCount metriği için bir sorgu, eventName: "purchase" ve eventCount: 0 satırına sahip olmaz.
returnPropertyQuota

boolean

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

object (Comparison)

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