Method: properties.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 tablodur. Metrikler, mülkünüzdeki kullanıcı etkinliğinin ayrı ayrı ölçümleridir (ör. etkin kullanıcı sayısı veya etkinlik sayısı). Boyutlar, metrikleri ülke veya etkinlik adı gibi bazı yaygın ölçütlere göre ayırır.

İstek oluşturma ve yanıtları anlama rehberi için Rapor Oluşturma başlıklı makaleyi inceleyin.

HTTP isteği

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

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

Yol parametreleri

Parametreler
property

string

Etkinlikleri izlenen bir Google Analytics GA4 mülk tanımlayıcısı. Gövdede değil, URL yolunda belirtilir. Daha fazla bilgi için Mülk kimliğinizi nerede bulacağınızı öğrenin. Toplu istekte, bu özellik belirtilmemiş veya grup düzeyindeki mülkle tutarlı olmalıdır.

Örnek: mülkler/1234

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla veriler içerir:

JSON gösterimi 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Alanlar
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.
dimensionFilter

object (FilterExpression)

Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek için Boyut Filtrelerinin Temelleri bölümünü inceleyebilirsiniz. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. SQL'in ilişkisine benzer şekilde rapor satırlarının toplanmasından sonra uygulanır. Boyutlar bu filtrede kullanılamaz.
offset

string (int64 format)

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

Sayfalara ayırma sırasında ilk istek ofseti belirtmez veya benzer şekilde, ofseti 0 olarak ayarlar. İlk istek satırların ilk limit kadarını döndürür. İkinci istek, ilk isteğin limit değerine göre ofseti ayarlar; ikinci istek, satırların ikinci limit kadarını döndürür.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi edinmek için Sayfalara ayırma bölümüne bakın.
limit

string (int64 format)

Döndürülecek satır sayısı. Belirtilmemesi durumunda 10.000 satır döndürülür. API, istediğiniz sayıda satırdan bağımsız olarak istek başına maksimum 250.000 satır döndürür. limit pozitif olmalıdır.

Ayrıca, limit kadar çok boyut değeri yoksa API, istenen limit değerinden daha az satır döndürebilir. Örneğin, country boyutu için 300'den az olası değer vardır. Bu nedenle, yalnızca country ile ilgili raporlama yaparken limit öğesini daha yüksek bir değere ayarlasanız bile 300'den fazla satır elde edemezsiniz.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi edinmek için Sayfalara ayırma bölümüne bakın.
metricAggregations[]

enum (MetricAggregation)

Metriklerin toplanması. Toplu metrik değerleri, boyutValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
orderBys[]

object (OrderBy)

Satırların yanıtta nasıl sıralanacağını belirtir.
currencyCode

string

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

object (CohortSpec)

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

boolean

Yanlış veya ayarlanmadan bırakılırsa tüm metriklerin 0'a eşit olduğu 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.

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

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

boolean

Bu Analytics Mülkü'nün kotasının mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, ÖzellikQuota 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