REST Resource: properties.reportTasks

Kaynak: ReportTask

Belirli bir rapor görevi yapılandırması.

JSON gösterimi 
{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}
Alanlar
name

string

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

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

object (ReportMetadata)

Yalnızca çıkış. Belirli bir rapor görevinin rapor meta verileridir. Bir rapor hakkında bilgi sağlar. Genellikle şu bilgileri içerir: raporun kaynak adı, raporun durumu, raporun oluşturulduğu zaman damgası vb.

ReportDefinition

Bir raporun nasıl çalıştırılması gerektiğinin tanımı.

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
}
Alanlar
dimensions[]

object (Dimension)

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

object (Metric)

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

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 dahil edilir. Bir kohort isteğinde bu dateRanges belirtilmemelidir.
dimensionFilter

object (FilterExpression)

İsteğe bağlı. Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek üzere örnekler için Boyut Filtrelerinin Temelleri bölümüne bakın. Bu filtrede metrikler kullanılamaz.
metricFilter

object (FilterExpression)

İsteğe bağlı. Metriklerin filtre koşulu. Rapordaki satırlar toplandıktan sonra, SQL sahip tümcesine benzer şekilde uygulanır. Boyutlar bu filtrede kullanılamaz.
offset

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 başlangıçtaki rapor görevi, sınırı 10.000 ve ofseti 0 olan ilk 10.000 satırı içerebilir. Ardından, başka bir rapor görevi, sınırı 10.000 ve ofset değeri 10.000 olan sonraki 10.000 satırı kapsayabilir.
limit

string (int64 format)

İsteğe bağlı. Raporda döndürülecek satır sayısı. Belirtilmezse 10.000 satır döndürülür. API, istediğiniz sayıda satırdan bağımsız olarak istek başına en fazla 250.000 satır döndürür. limit pozitif olmalıdır.

Ayrıca, limit kadar 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 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.
metricAggregations[]

enum (MetricAggregation)

İsteğe bağlı. Metriklerin toplanması. Toplu metrik değerleri, boyutValues'un "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.
orderBys[]

object (OrderBy)

İsteğe bağlı. Satırların yanıtta nasıl sıralandığını belirtir.
currencyCode

string

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

object (CohortSpec)

İsteğe bağlı. Bu istekle ilişkili grup grubu. "Kohort" isteğinde bir kohort grubu varsa boyutu bulunmalıdır.
keepEmptyRows

boolean

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

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ği günlüğe kaydetmediyse eventName boyutu ve eventCount metriği için yapılan sorguda eventName: "purchase" ifadesini içeren bir satır bulunmaz ve eventCount: 0.

Boyut

Boyutlar verilere ilişkin özelliklerdir. Örneğin "şehir" boyutu, bir etkinliğin kaynağı olan şehri belirtir. Rapor yanıtlarındaki boyut değerleri dizedir; Örneğin, şehir "Ankara" olabilir. "İstanbul".

JSON gösterimi 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Alanlar
name

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ı konusuna bakın.

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

dimensionFilter, orderBys, dimensionExpression ve pivots içinde boyutlara name tarafından referans verilmiştir.
dimensionExpression

object (DimensionExpression)

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

DimensionExpression

Birden fazla boyuta sahip bir formülün sonucu olan boyutu ifade etmek için kullanılır. Örnek kullanımlar: 1) Küçük harf(boyut) 2) bitişik(boyut1, simge, boyut2).

JSON gösterimi 
{

  // 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.
}
Alanlar
Birleştirme alanı one_expression. DimensionExpression için bir boyut ifadesi türü belirtin. one_expression şunlardan yalnızca biri olabilir:
lowerCase

object (CaseExpression)

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

object (CaseExpression)

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

object (ConcatenateExpression)

Boyut değerlerini tek bir boyutla birleştirmek için kullanılır. Örneğin, "ülke, şehir": concatenate(ülke, ", ", şehir).

CaseExpression

Boyut değerini tek bir büyük/küçük harfe dönüştürmek için kullanılır.

JSON gösterimi 
{
  "dimensionName": string
}
Alanlar
dimensionName

string

Bir boyutun adı. Ad, isteğin boyutlar alanındaki bir adı ifade etmelidir.

ConcatenateExpression

Boyut değerlerini tek bir boyutla birleştirmek için kullanılır.

JSON gösterimi 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Alanlar
dimensionNames[]

string

Boyutların adları. Adlar, isteğin boyutlar alanındaki adlara tekrar atıfta bulunmalıdır.
delimiter

string

Boyut adları arasına yerleştirilen ayırıcı.

Ayırıcılar genellikle "|" gibi tek karakterlerden oluşur veya "," ancak daha uzun dizeler olabilir. Sınırlayıcı bir boyut değeri içeriyorsa her ikisi de hiçbir ayrım olmadan yanıtta mevcut olacaktır. Örneğin boyut 1 değer = "US,FR", boyut 2 değer = "JP" ve ayırıcı = "," ise yanıt "US,FR,JP" ifadesini içerir.

Metrik

Bir raporun nicel ölçümleri. Örneğin, eventCount metriği toplam etkinlik sayısını ifade eder. İstekler için en fazla 10 metriğe izin verilir.

JSON gösterimi 
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
Alanlar
name

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, screenPageViews/sessions ise bu metriğin adı = viewsPerSession olarak adlandırılabilir. Seçtiğiniz metrik adları, ^[a-zA-Z0-9_]$ normal ifadesiyle eşleşmelidir.

Metriklere metricFilter, orderBys ve expression metriğinde name tarafından referans verilir.
expression

string

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

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 expression metriğinde kullanılabilir.

DateRange

Kesintisiz bir gün grubu: startDate, startDate + 1, ..., endDate. İsteklere en fazla 4 tarih aralığına izin verilir.

JSON gösterimi 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Alanlar
startDate

string

Sorgunun YYYY-MM-DD biçimindeki kapsayıcı 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 tahmin edilir.
endDate

string

Sorgunun YYYY-MM-DD biçimindeki kapsayıcı 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 tahmin edilir.
name

string

Bu tarih aralığına bir ad atar. dateRange boyutu, bir rapor yanıtında bu ada ayarlanır. Ayarlanırsa date_range_ veya RESERVED_ ile başlayamaz. Politika ayarlanmazsa tarih aralıkları istekteki sıfır tabanlı dizinleriyle adlandırılır: date_range_0, date_range_1 vb.

FilterExpression

Boyut veya metrik filtrelerini ifade etmek için. AynıFilterExpression'daki alanların tüm boyutlar veya tüm metrikler olması gerekir.

JSON gösterimi 
{

  // 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.
}
Alanlar
Birleştirme alanı expr. FilterExpression için bir filtre ifadesi türü belirtin. expr şunlardan yalnızca biri olabilir:
andGroup

object (FilterExpressionList)

andGroup'taki Filtre İfadeleri'nin bir VE ilişkisi vardır.
orGroup

object (FilterExpressionList)

orGroup'taki Filtre İfadeleri'nin bir VEYA ilişkisi vardır.
notExpression

object (FilterExpression)

filterExpression, notExpression DEĞİL.
filter

object (Filter)

Temel filtre. Aynı Filtre İfadesi'nde, filtrenin tüm alan adlarının ya tüm boyutlar ya da tüm metrikler olması gerekir.

FilterExpressionList

Filtre ifadelerinin listesi.

JSON gösterimi 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Alanlar
expressions[]

object (FilterExpression)

Filtre ifadelerinin listesi.

Filtre

Boyut veya metrik değerlerini filtrelemek için kullanılan bir ifade.

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

string

Boyut adı veya metrik adı. Boyutlarda veya metriklerde tanımlanan bir ad olmalıdır.
Birleştirme alanı one_filter. Filter için bir filtre türü belirtin. one_filter şunlardan yalnızca biri olabilir:
stringFilter

object (StringFilter)

Dizelerle ilgili filtre.
inListFilter

object (InListFilter)

Liste değerleri filtresi.
numericFilter

object (NumericFilter)

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

object (BetweenFilter)

İki değer arasında bir filtre.

StringFilter

Dize filtresi

JSON gösterimi 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Alanlar
matchType

enum (MatchType)

Bu filtre için eşleme türü.
value

string

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

boolean

True (doğru) ise dize değeri büyük/küçük harfe duyarlıdır.

MatchType

Dize filtresinin eşleşme türü

Sıralamalar
MATCH_TYPE_UNSPECIFIED Belirtilmedi
EXACT Dize değerinin tam eşleşmesi.
BEGINS_WITH Dize değeriyle başlar.
ENDS_WITH Dize değeriyle biter.
CONTAINS Dize değerini içerir.
FULL_REGEXP Dize değerine sahip normal ifade için tam eşleşme.
PARTIAL_REGEXP Normal ifade için dize değeriyle kısmi eşleşme.

InListFilter

Sonucun, dize değerleri listesinde olması gerekir.

JSON gösterimi 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Alanlar
values[]

string

Dize değerlerinin listesi. Boş bırakılamaz.
caseSensitive

boolean

True (doğru) ise dize değeri büyük/küçük harfe duyarlıdır.

NumericFilter

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

JSON gösterimi 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Alanlar
operation

enum (Operation)

Bu filtre için işlem türü.
value

object (NumericValue)

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

İşlem

Bir sayısal filtreye uygulanan işlem

Sıralamalar
OPERATION_UNSPECIFIED Belirtilmedi.
EQUAL Eşit
LESS_THAN Küçüktür
LESS_THAN_OR_EQUAL Küçük veya eşittir
GREATER_THAN Şundan büyük:
GREATER_THAN_OR_EQUAL Büyüktür veya eşittir

NumericValue

Bir sayıyı temsil eder.

JSON gösterimi 
{

  // 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.
}
Alanlar
Birleştirme alanı one_value. one_value sayısal değerlerinden biri, aşağıdakilerden yalnızca biri olabilir:
int64Value

string (int64 format)

Tam sayı değeri
doubleValue

number

Çift değer

BetweenFilter

Sonucun iki sayı (her iki sayı da dahil) arasında olması gerektiğini belirtmek için.

JSON gösterimi 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Alanlar
fromValue

object (NumericValue)

Bu sayıyla başlar.
toValue

object (NumericValue)

Bu sayıyla biter.

MetricAggregation

Metriklerin toplamını gösterir.

Sıralamalar
METRIC_AGGREGATION_UNSPECIFIED Belirtilmemiş operatör.
TOTAL SUM operatörü.
MINIMUM Minimum operatör.
MAXIMUM Maksimum operatör.
COUNT Sayı operatörü.

Sıralama Ölçütü

Sıralama ölçütü, satırların yanıtta nasıl sıralanacağını tanımlar. Örneğin, satırları azalan etkinlik sayısına göre sıralamak tek bir sıralamadır. Satırları etkinlik adı dizesine göre sıralamak ise farklı bir sıralamadır.

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

boolean

True (doğru) ise azalan düzende sıralar.
Birleştirme alanı one_order_by. OrderBy için ölçütüne göre bir sipariş türü belirtin. one_order_by şunlardan yalnızca biri olabilir:
metric

object (MetricOrderBy)

Sonuçları metrik değerlerine göre sıralar.
dimension

object (DimensionOrderBy)

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

MetricOrderBy

Metrik değerlerine göre sıralar.

JSON gösterimi 
{
  "metricName": string
}
Alanlar
metricName

string

Sıralama ölçütü isteğindeki metrik adı.

DimensionOrderBy

Boyut değerlerine göre sıralar.

JSON gösterimi 
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
Alanlar
dimensionName

string

Sıralama ölçütü isteğindeki boyut adı.
orderType

enum (OrderType)

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

OrderType

Dize boyutu değerlerini sıralama kuralı.

Sıralamalar
ORDER_TYPE_UNSPECIFIED Belirtilmedi.
ALPHANUMERIC Unicode kod noktasına göre alfanümerik sıralama. Örneğin, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Küçük harf Unicode kod noktasına göre, büyük/küçük harfe duyarlı olmayan sıralama. Örneğin, "2" < "A" < "b" < "X" < "z".
NUMERIC Boyut değerleri, sıralamadan önce sayılara dönüştürülür. Örneğin, SAYISAL sıralamada, "25" < "100" ve ALPHANUMERIC sıralamasında "100" < "25". Sayısal olmayan boyut değerlerinin tümünün, tüm sayısal değerlerin altında eşit sıralama değeri vardır.

CohortSpec

Bir grup raporu için kohortların spesifikasyonu.

Grup raporları, grup için bir zaman serisi kullanıcıları elde tutma işlemi oluşturur. Örneğin, Eylül'ün ilk haftasında edinilen kullanıcı kohortunu seçebilir ve bu kohortu sonraki altı hafta boyunca takip edebilirsiniz. Eylül grubunun ilk haftasında edinilen kullanıcıların seçilmesi cohort nesnesinde belirtilir. Sonraki altı hafta boyunca bu kohortun devamı cohortsRange nesnesinde belirtilir.

Örnekler için Kohort Raporu Örnekleri bölümüne bakın.

Rapor yanıtında, uygulamanızın üç hafta sonra bu grubun% 60'ını, altı hafta sonra da bu kohortun% 25'ini koruduğunu belirten bir haftalık zaman serisi gösterilebilir. Bu iki yüzde, cohortActiveUsers/cohortTotalUsers metriğiyle hesaplanabilir ve raporda ayrı satırlar olur.

JSON gösterimi 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Alanlar
cohorts[]

object (Cohort)

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

Çoğu kohort raporu yalnızca tek bir kohort tanımlar. Birden fazla kohort belirtilirse her kohort raporda adlarıyla tanınabilir.
cohortsRange

object (CohortsRange)

Kohort raporları, geniş bir raporlama tarih aralığı boyunca kohortları takip eder. Bu aralık, kohortların takip edileceği ofset süresini belirtir.
cohortReportSettings

object (CohortReportSettings)

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

Kohort

Kohort seçim ölçütü tanımlar. Kohort, ortak bir özelliğe sahip kullanıcı grubudur. Örneğin, aynı firstSessionDate değerine sahip kullanıcılar aynı kohorta dahildir.

JSON gösterimi 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Alanlar
name

string

Bu gruba bir ad atar. cohort boyutu, bir rapor yanıtında bu ada ayarlanır. Ayarlanırsa cohort_ veya RESERVED_ ile başlayamaz. Politika ayarlanmazsa kohortlar sıfır tabanlı dizinlerine (cohort_0, cohort_1 vb.) göre adlandırılır.
dimension

string

Grup tarafından kullanılan boyut. Zorunludur ve yalnızca firstSessionDate desteklenir.
dateRange

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, bir grup raporunda bulunan etkinlik verilerinin tam tarih aralığını belirtmez. Bir grup raporunda bu dateRange, cohortsRange öğesinde bulunan ayrıntı düzeyi ve ofsetle artırılır; Genişletilmiş raporlama tarih aralığına ait etkinlik verileri bir grup raporunda mevcut.

Bir kohort isteğinde bu dateRange gereklidir ve RunReportRequest ya da RunPivotReportRequest içindeki dateRanges belirtilmemelidir.

Bu dateRange, genellikle grubun 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üzeyini kullanıyorsa bu dateRange, Pazar gününden 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ünde sona erecek şekilde bir aya hizalanabilir.

CohortsRange

Bir grup raporu için genişletilmiş raporlama tarih aralığını yapılandırır. Kohortların takip edileceği ofset süresini belirtir.

JSON gösterimi 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Alanlar
granularity

enum (Granularity)

Zorunlu. Grup raporunun genişletilmiş raporlama tarih aralığı için startOffset ve endOffset öğelerini yorumlamada kullanılan ayrıntı düzeyi.
startOffset

integer

startOffset, bir grup raporu için genişletilmiş raporlama tarih aralığının başlangıç tarihini belirtir. startOffset genellikle 0 olarak ayarlanır. Böylece raporlarda, kohortun edinildiği tarihten sonraki veriler yer alır.

granularity değeri DAILY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate kadarı artı startOffset gün olur.

granularity değeri WEEKLY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate kadarı artı startOffset * 7 gün olur.

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının startDate değeri grubun startDate kadarı artı startOffset * 30 gün olur.
endOffset

integer

Zorunlu. endOffset, bir grup raporu için genişletilmiş raporlama tarih aralığının bitiş tarihini belirtir. endOffset, herhangi bir pozitif tam sayı olabilir ancak genellikle 5-10 olarak ayarlanır. Böylece raporlar, sonraki birkaç ayrıntı 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 kadarı artı endOffset gün olur.

granularity değeri WEEKLY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate kadarı artı endOffset * 7 gün olur.

granularity değeri MONTHLY ise genişletilmiş raporlama tarih aralığının endDate değeri grubun endDate kadarı artı endOffset * 30 gün olur.

Ayrıntı düzeyi

Grup raporunun genişletilmiş raporlama tarih aralığı için startOffset ve endOffset öğelerini yorumlamada kullanılan ayrıntı düzeyi.

Sıralamalar
GRANULARITY_UNSPECIFIED Hiçbir zaman belirtilmemelidir.
DAILY Günlük ayrıntı düzeyi. Genellikle grubun dateRange değeri tek bir günse ve istek cohortNthDay içeriyorsa kullanılır.
WEEKLY Haftalık ayrıntı düzeyi. Genellikle grubun dateRange tarihi bir haftaysa (Pazar günü başlayıp Cumartesi günü sona eren) ve istek cohortNthWeek içeriyorsa kullanılır.
MONTHLY Aylık ayrıntı düzeyi. Genellikle grubun dateRange tarihi bir aysa ve istek cohortNthMonth içeriyorsa kullanılır.

CohortReportSettings

Grup raporunun isteğe bağlı ayarları.

JSON gösterimi 
{
  "accumulate": boolean
}
Alanlar
accumulate

boolean

True (doğru) ise, sonucu ilk temas gününden bitiş gününe kadar toplar. RunReportRequest sisteminde desteklenmiyor.

ReportMetadata

Belirli bir rapor görevi için rapor meta verileri.

JSON gösterimi 
{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}
Alanlar
creationQuotaTokensCharged

integer

Yalnızca çıkış. Rapor oluşturulurken ücretlendirilen toplam kota jetonları. Bu jeton sayısı CREATING durumundaki etkinliğe dayandığından, bir rapor görevi ACTIVE veya FAILED durumuna girdiğinde bu jeton ücreti sabitlenir.
state

enum (State)

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

string (Timestamp format)

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

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
taskRowCount

integer

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

string

Yalnızca çıkış. Oluşturma işlemi sırasında bir rapor görevi başarısız olursa hata mesajı doldurulur.
totalRowCount

integer

Yalnızca çıkış. Google Analytics depolama alanındaki toplam satır sayısı. Mevcut raporun ötesinde ek veri satırlarını sorgulamak istiyorsanız bu raporlar, 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ı belirtir.

Ö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 30'dur ve bu, 30 satırın tamamı için veri 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ındaki verileri dahil etmek için 30 satırlık tam kümeye erişmek üzere totalRowCount kullanılarak yeni bir rapor görevi oluşturulabilir. veri değerindedir.

Eyalet

İşleme durumu.

Sıralamalar
STATE_UNSPECIFIED Belirtilmemiş durum hiçbir zaman kullanılmaz.
CREATING Rapor şu anda oluşturuluyor ve gelecekte kullanıma sunulacak. Oluşturma işlemi, CreateRapor çağrısından hemen sonra gerçekleşir.
ACTIVE Rapor tamamen oluşturuldu ve sorgulanmaya hazır.
FAILED Rapor oluşturulamadı.

Yöntemler

create

 Rapor görevi oluşturma işlemini başlatır.

get

 Belirli bir rapor göreviyle ilgili rapor meta verilerini alır.

list

 Bir mülke ait tüm rapor görevlerini listeler.

query

 Rapor görevinin içeriğini alır.