Method: properties.runPivotReport

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

Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlardan daha gelişmiş ve ifade eden biçimlerdir. Pivot raporda boyutlar yalnızca bir pivot öğesine dahil olduklarında görünürler. Verilerinizi daha ayrıntılı incelemek için birden fazla pivot tablo belirtilebilir.

HTTP isteği

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

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. Bir toplu istekte bu özellik belirtilmemiş veya toplu düzey mülkle tutarlı olmalıdır.

Örnek: mülkler/1234

İstek metni

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

JSON gösterimi
{
  "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
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.

Yanıt metni

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