Method: runPivotReport

Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlara göre daha gelişmiş ve anlamlı biçimlerdir. Bir pivot raporunda, boyutlar yalnızca özete dahil edilirse görünür. Verilerinizi daha ayrıntılı olarak incelemek için birden çok özet belirtilebilir.

HTTP isteği

POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

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

JSON gösterimi
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Alanlar
entity

object (Entity)

Etkinlikleri izlenen bir mülk. Toplu istekte bu varlığın belirtilmemiş olması veya grup düzeyindeki varlıkla tutarlı olması gerekir.

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.

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.

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.

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.

currencyCode

string

ISO4217 biçiminde, "AED", "USD", "JPY" gibi bir para birimi kodu. Alan boşsa raporda varlığı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ı olarak kaldırılmadıklarında döndürülür.

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 bölümünde döndürülür.

Yanıt gövdesi

Başarılıysa yanıt metni, RunPivotReportResponse öğesinin bir örneğini içerir.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics