REST Resource: properties.reportTasks

{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}

string

Yalnızca çıkış. Tanımlayıcı. Oluşturma sırasında atanan rapor görevi kaynağı adı. Biçim: "properties/{property}/reportTasks/{reportTask}"

object (ReportDefinition)

İsteğe bağlı. Rapor verilerini getirmek için kullanılan ve raporun yapısını açıklayan bir rapor tanımı. Genellikle rapora dahil edilecek alanları ve verileri filtrelemek için kullanılacak ölçütleri içerir.

object (ReportMetadata)

Yalnızca çıkış. Bir rapor hakkında bilgi sağlayan, belirli bir rapor görevi için rapor meta verileri. Genellikle şu bilgileri içerir: raporun kaynak adı, raporun durumu, raporun oluşturulduğu zaman damgası vb.

{
  "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
}

object (Dimension)

İsteğe bağlı. İstenen ve görüntülenen boyutlar.

object (Metric)

İsteğe bağlı. İstenen ve gösterilen metrikler.

object (DateRange)

İsteğe bağlı. 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.

object (FilterExpression)

İsteğe bağlı. Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek için Boyut Filtreleriyle İlgili Temel Bilgiler başlıklı makaleyi inceleyin. Metrikler bu filtrede kullanılamaz.

object (FilterExpression)

İsteğe bağlı. Metriklerin filtre ifadesi. SQL'in yan tümcesine benzer şekilde, raporun satırları toplandıktan sonra uygulanır. Boyutlar bu filtrede kullanılamaz.

string (int64 format)

İsteğe bağlı. Google Analytics Depolama Alanı'ndaki başlangıç satırının satır sayısı. İlk satır, 0. satır olarak sayılır.

Bir rapor görevi oluştururken, offset ve limit parametreleri, oluşturulan rapora dahil edilecek Google Analytics depolama alanındaki veri satırlarının alt kümesini tanımlar. Örneğin, Google Analytics depolama alanında toplam 300.000 satır varsa ilk rapor görevinin ilk 10.000 satırı sınırı 10.000, ofseti ise 0 olabilir. Ardından, başka bir rapor görevi, sınırı 10.000, ofseti ise 10.000 olmak üzere sonraki 10.000 satırı kapsayabilir.

string (int64 format)

İsteğe bağlı. Raporda döndürülecek satır sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın 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 satırdan 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 hakkında rapor oluştururken limit değerini daha yüksek bir değere ayarlasanız bile 300'den fazla satır alamazsınız.

enum (MetricAggregation)

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

object (OrderBy)

İsteğe bağlı. Yanıtta satırların nasıl sıralandığını belirtir.

string

İsteğe bağlı. "AED", "USD", "JPY" gibi ISO4217 biçiminde bir para birimi kodu. Alan boşsa rapor mülkün varsayılan para birimini kullanır.

object (CohortSpec)

İsteğe bağlı. Bu istekle ilişkili kohort grubu. İstekte bir kohort grubu varsa "kohort" boyutu bulunmalıdır.

boolean

İsteğe bağlı. 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.

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

Örneğin bir mülk hiçbir zaman purchase etkinliğini günlüğe kaydetmemişse eventName boyutu ve eventCount metriği için yapılan sorguda eventName ve eventCount: 0 içeren bir satır bulunmaz.

{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}

string

Boyutun adı. runReport ve batchRunReports gibi temel raporlama yöntemleri tarafından desteklenen boyut adlarının listesi için API Boyutları'na bakın. runRealtimeReport yöntemi tarafından desteklenen boyut adlarının listesi için Gerçek Zamanlı Boyutlar bölümüne bakın. runFunnelReport yöntemi tarafından desteklenen boyut adlarının listesi için Dönüşüm Hunisi Boyutları bölümünü inceleyin.

dimensionExpression belirtilirse name, izin verilen karakter kümesi içinde istediğiniz herhangi bir dize olabilir. Örneğin bir dimensionExpression, country ve city'yi birleştiriyorsa bu boyutu countryAndCity olarak adlandırabilirsiniz. Seçtiğiniz boyut adları, ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Boyutlara dimensionFilter, orderBys, dimensionExpression ve pivots içinde name tarafından referans veriliyor.

object (DimensionExpression)

Bir boyut, birden fazla boyut ifadesinin bir sonucu olabilir. Örneğin, "ülke, şehir" boyutu: bitiştir(ülke, ", ", şehir).

{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}

object (CaseExpression)

Bir boyut değerini küçük harfe dönüştürmek için kullanılır.

object (CaseExpression)

Bir boyut değerini büyük harfe dönüştürmek için kullanılır.

object (ConcatenateExpression)

Boyut değerlerini tek bir boyut olarak birleştirmek için kullanılır. Örneğin, "ülke, şehir" boyutu: bitiştir(ülke, ", ", şehir).

{
  "dimensionName": string
}

string

Boyut adı. Ad, tekrar isteğin boyutlar alanındaki bir ada karşılık gelmelidir.

{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}

string

Boyutların adları. Adlar, isteğin boyutlar alanındaki adlara geri dönmelidir.

string

Boyut adları arasına yerleştirilen sınırlayıcı.

Sınırlayıcılar genellikle "|" veya "" gibi tek karakterlerdir, ancak daha uzun dizeler de olabilir. Bir boyut değeri sınırlayıcıyı içeriyorsa, her iki değer de herhangi bir ayrım olmadan yanıt olarak mevcut olur. Örneğin boyut 1 değeri = "US,FR", boyut 2 değeri = "JP" ve ayırıcı = "," ise yanıt "US,FR,JP" ifadesini içerir.

{
  "name": string,
  "expression": string,
  "invisible": boolean
}

string

Metriğin adı. runReport ve batchRunReports gibi temel raporlama yöntemleri tarafından desteklenen metrik adlarının listesi için API Metrikleri'ne bakın. runRealtimeReport yöntemi tarafından desteklenen metrik adlarının listesi için Gerçek Zamanlı Metrikler konusuna bakın. runFunnelReport yöntemi tarafından desteklenen metrik adlarının listesi için Dönüşüm Hunisi Metrikleri'ne bakın.

expression belirtilirse name, izin verilen karakter kümesi içinde istediğiniz herhangi bir dize olabilir. Örneğin, expression değeri screenPageViews/sessions ise bu metriğin adını viewsPerSession olarak adlandırabilirsiniz. Seçtiğiniz metrik adları, ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Metriklere metricFilter, orderBys ve expression metriğinde name tarafından referansta bulunuluyor.

string

Türetilen metrikler için matematiksel ifade. Örneğin, Kullanıcı başına etkinlik sayısı metriği eventCount/totalUsers'dir.

boolean

Bir metriğin rapor yanıtında görünmez olup olmadığını belirtir. Bir metrik görünmezse yanıtta sütun oluşturmaz, ancak metricFilter, orderBys veya bir metrik expression içinde kullanılabilir.

{
  "startDate": string,
  "endDate": string,
  "name": string
}

string

Sorgunun YYYY-MM-DD biçimindeki dahil başlangıç tarihi. endDate tarihinden sonra olamaz. NdaysAgo, yesterday veya today biçimi de kabul edilir. Bu durumda tarih, mülkün raporlama saat dilimine göre belirlenir.

string

Sorgunun YYYY-MM-DD biçimindeki dahil bitiş tarihi. startDate tarihinden önce olamaz. NdaysAgo, yesterday veya today biçimi de kabul edilir. Bu durumda tarih, mülkün raporlama saat dilimine göre belirlenir.

string

Bu tarih aralığına bir ad atar. dateRange boyutu, bir rapor yanıtında bu ada göre değerlendirilir. Ayarlanırsa date_range_ veya RESERVED_ ile başlayamaz. Ayarlanmazsa tarih aralıkları, istekteki sıfır tabanlı dizine göre adlandırılır: date_range_0, date_range_1 vb.

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}

object (FilterExpressionList)

andGroup içindeki FilterExpressions, VE ilişkisine sahip.

object (FilterExpressionList)

orGroup içindeki FilterExpressions'ın VEYA ilişkisi var.

object (FilterExpression)

FilterExpression, notExpression'tan DEĞİLDİR.

object (Filter)

Temel bir filtre. Aynı filterExpression'da, filtrenin tüm alan adlarının ya bütün boyutlar ya da tüm metrikler olması gerekir.

{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}

object (FilterExpression)

Filtre ifadelerinin listesi.

{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

string

Boyut adı veya metrik adı. Boyutlarda veya metriklerde tanımlanan bir ad olmalıdır.

object (StringFilter)

Dizelerle ilgili filtre.

object (InListFilter)

Liste değerlerinde için bir filtre.

object (NumericFilter)

Sayısal değerler veya tarih değerleri için bir filtre.

object (BetweenFilter)

İki değer arasındaki filtre.

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

Bu filtrenin eşleme türü.

string

Eşleşme için kullanılan dize değeri.

boolean

Değer true ise dize değeri büyük/küçük harfe duyarlıdır.

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

Dize değerlerinin listesi. Boş olmamalıdır.

boolean

Değer true ise dize değeri büyük/küçük harfe duyarlıdır.

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

Bu filtrenin işlem türü.

object (NumericValue)

Sayısal bir değer veya tarih değeridir.

{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}

string (int64 format)

Tam sayı değeri

number

Çift değer

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

Bu sayıyla başlar.

object (NumericValue)

Bu numarayla biter.

{
  "desc": boolean,

  // Union field one_order_by can be only one of the following:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of list of possible types for union field one_order_by.
}

boolean

True (doğru) değerine ayarlanırsa azalan düzene göre sıralar.

object (MetricOrderBy)

Sonuçları bir metriğin değerlerine göre sıralar.

object (DimensionOrderBy)

Sonuçları bir boyutun değerlerine göre sıralar.

{
  "metricName": string
}

string

Sıralama isteğindeki metrik adı.

{
  "dimensionName": string,
  "orderType": enum (OrderType)
}

string

Sıralama isteğindeki boyut adı.

enum (OrderType)

Boyut değeri sıralaması kuralını kontrol eder.

{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}

object (Cohort)

Kullanıcıları kohortlar halinde gruplandırmak için seçim ölçütlerini tanımlar.

Çoğu grup raporu yalnızca bir kohortu tanımlar. Birden çok kohort belirtilirse her kohort raporda adıyla tanınabilir.

object (CohortsRange)

Grup raporları, daha geniş bir raporlama tarih aralığı boyunca grupları takip eder. Bu aralık, kohortların takip edilmesi için bir ofset süresi belirtir.

object (CohortReportSettings)

Grup raporu için isteğe bağlı ayarlar.

{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}

string

Bu gruba bir ad atar. cohort boyutu, bir rapor yanıtında bu ada göre değerlendirilir. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Ayarlanmazsa gruplar sıfır tabanlı dizinleri cohort_0, cohort_1 vb. ile adlandırılır.

string

Grup tarafından kullanılan boyut. Zorunludur ve yalnızca firstSessionDate kullanımını destekler.

object (DateRange)

Grup, ilk temas tarihi dateRange içinde tanımlanan başlangıç tarihi ile bitiş tarihi arasında olan kullanıcıları seçer. Bu dateRange, grup raporunda bulunan etkinlik verilerinin tam tarih aralığını belirtmez. Grup raporunda bu dateRange, cohortsRange öğesinde mevcut olan ayrıntı düzeyi ve ofset ile genişletilir. Genişletilmiş raporlama tarih aralığına ait etkinlik verileri ise kohort raporunda bulunur.

Kohort isteğinde bu dateRange gereklidir ve RunReportRequest veya RunPivotReportRequest içindeki dateRanges belirtilmemelidir.

Bu dateRange, genellikle kohortun ayrıntı düzeyiyle uyumlu olmalıdır. CohortsRange, günlük ayrıntı düzeyi kullanıyorsa bu dateRange tek bir gün olabilir. CohortsRange haftalık ayrıntı düzeyi kullanıyorsa bu dateRange, Pazar'dan başlayıp Cumartesi günü sona eren bir hafta sınırına hizalanabilir. CohortsRange, aylık ayrıntı düzeyini kullanıyorsa bu dateRange, ayın ilk gününden başlayıp son günü sona erecek şekilde bir aya hizalanabilir.

{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}

enum (Granularity)

Zorunlu. Grup raporunun genişletilmiş raporlama tarih aralığına ait startOffset ve endOffset değerlerini yorumlamak için kullanılan ayrıntı düzeyi.

integer

startOffset, grup raporu için genişletilmiş raporlama tarih aralığının başlangıç tarihini belirtir. startOffset genellikle 0 olarak ayarlanır. Böylece raporlarda grup edinmeden ileriye yönelik veriler yer alır.

granularity değeri DAILY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate değerine ek olarak startOffset gündür.

granularity değeri WEEKLY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate değerine ek olarak startOffset * 7 gündür.

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate değerine ek olarak startOffset * 30 gündür.

integer

Zorunlu. endOffset, grup raporu için genişletilmiş raporlama tarih aralığının bitiş tarihini belirtir. endOffset herhangi bir pozitif tam sayı olabilir ancak genellikle 5 ile 10 arasında bir değere ayarlanır. Böylece raporlar sonraki birkaç ayrıntı düzeyi dönemi için kohortla ilgili verileri içerir.

granularity değeri DAILY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate değerine ek olarak endOffset gündür.

granularity değeri WEEKLY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate değerine ek olarak endOffset * 7 gündür.

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate değerine ek olarak endOffset * 30 gündür.

{
  "accumulate": boolean
}

boolean

Doğru değerine ayarlanırsa ilk temas gününden bitiş gününe kadar sonucu toplar. RunReportRequest dilinde desteklenmiyor.

{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}

integer

Yalnızca çıkış. Raporun oluşturulması sırasında alınan toplam kota jetonları. Bu jeton sayısı CREATING durumundaki etkinliğe dayandığından bu jeton ücreti bir rapor görevi ACTIVE veya FAILED durumuna girdiğinde sabitlenir.

enum (State)

Yalnızca çıkış. Bu rapor görevinin mevcut durumu.

string (Timestamp format)

Yalnızca çıkış. reportTasks.create işlevinin çağrıldığı ve raporun CREATING durumunun başladığı zaman.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

integer

Yalnızca çıkış. Rapor sonucundaki toplam satır sayısı. Bu alan, eyalet etkin olduğunda doldurulur. Mevcut raporun sınırları içinde sayfalandırma için taskRowCount kullanabilirsiniz.

string

Yalnızca çıkış. Bir rapor görevi oluşturma sırasında başarısız olursa hata mesajı doldurulur.

integer

Yalnızca çıkış. Google Analytics depolama alanındaki toplam satır sayısı. Mevcut raporun dışında ek veri satırlarını sorgulamak istiyorsanız bu satırlar totalRowCount temelinde yeni bir rapor görevi başlatabilir.

taskRowCount, özellikle geçerli raporla ilgili satır sayısını gösterir; totalRowCount ise Google Analytics depolama alanından alınan tüm verilerdeki toplam satır sayısını gösterir.

Örneğin, geçerli raporun taskRowCount değerinin 20 olduğunu ve ilk 20 satırdaki verileri gösterdiğini varsayalım. Eşzamanlı olarak, totalRowCount değeri 30 olur ve 30 satırın tümünde verilerin bulunduğunu gösterir. taskRowCount, ilk 20 satırı sayfalara ayırmak için kullanılabilir. Raporu genişletmek ve 30 satırın tamamından verileri dahil etmek için, 30 satırlık veri kümesinin tamamına erişmek amacıyla totalRowCount ile yeni bir rapor görevi oluşturulabilir.