Method: runReport

Google Analytics etkinlik verilerinizin özelleştirilmiş bir raporunu döndürür. Raporlar, Google Analytics izleme kodu tarafından toplanan verilerden türetilen istatistikleri içerir. API'den döndürülen veriler, istenen boyutlar ve metrikler için sütunlar içeren bir tablo gibidir. Metrikler, mülkünüzdeki kullanıcı etkinliklerinin (ör. etkin kullanıcı sayısı veya etkinlik sayısı) bağımsız ölçümleridir. Boyutlar, metrikleri ülke veya etkinlik adı gibi bazı yaygın ölçütlere göre ayırır.

HTTP isteği

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

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

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Alanlar
entity

object (Entity)

Etkinlikleri izlenen bir mülk. Bir toplu istekte, bu varlık belirtilmemiş veya grup düzeyindeki varlıkla tutarlı olmalıdır.
dimensions[]

object (Dimension)

İstenen ve görüntülenen boyutlar.
metrics[]

object (Metric)

İstenen ve gösterilen metrikler.
dateRanges[]

object (DateRange)

Okunacak verilerin tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırı sıfır tabanlı bir tarih aralığı dizini içerir. İki tarih aralığı çakışırsa çakışan günlere ait etkinlik verileri her iki tarih aralığının yanıt satırlarına eklenir. Grup isteğinde bu dateRanges belirtilmemelidir.
offset

string (int64 format)

Başlangıç satırının satır sayısıdır. İlk satır, 0. satır olarak sayılır.
limit

string (int64 format)

Döndürülecek satır sayısı. limit parametresi belirtilmezse 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 100.000 satır döndürür.
metricAggregations[]

enum (MetricAggregation)

Metriklerin toplamı. Toplu metrik değerleri,dimensionValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
dimensionFilter

object (FilterExpression)

Boyutların filtre ifadesi. Boyutların bu filtrede kullanılması istenmelidir. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre ifadesi. SQL toplama yan tümcesine benzer şekilde, toplama sonrası aşamasında uygulanır. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz.
orderBys[]

object (OrderBy)

Yanıtta satırların nasıl sıralandığını belirtir.
currencyCode

string

"AED", "USD", "JPY" gibi ISO4217 biçiminde bir para birimi kodu. Alan boşsa rapor, varlığın varsayılan para birimini kullanır.
cohortSpec

object (CohortSpec)

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

boolean

Yanlış veya belirtilmemişse 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ılmazsa döndürülür.
returnPropertyQuota

boolean

Bu 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.

Yanıt gövdesi

Başarılıysa yanıt metni, RunReportResponse öğ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