REST Resource: properties.reportTasks

Resource: ReportTask

Konfigurasi tugas laporan tertentu.

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

string

Hanya output. ID. Nama resource tugas laporan yang ditetapkan selama pembuatan. Format: "properties/{property}/reportTasks/{reportTask}"
reportDefinition

object (ReportDefinition)

Opsional. Definisi laporan untuk mengambil data laporan, yang menjelaskan struktur laporan. Biasanya mencakup kolom yang akan disertakan dalam laporan dan kriteria yang akan digunakan untuk memfilter data.
reportMetadata

object (ReportMetadata)

Hanya output. Metadata laporan untuk tugas laporan tertentu, yang memberikan informasi tentang laporan. Biasanya mencakup informasi berikut: nama resource laporan, status laporan, stempel waktu laporan dibuat, dll.

ReportDefinition

Definisi cara laporan harus dijalankan.

Representasi JSON 
{
  "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,
  "samplingLevel": enum (SamplingLevel)
}
Kolom
dimensions[]

object (Dimension)

Opsional. Dimensi yang diminta dan ditampilkan.
metrics[]

object (Metric)

Opsional. Metrik yang diminta dan ditampilkan.
dateRanges[]

object (DateRange)

Opsional. Rentang tanggal data yang akan dibaca. Jika beberapa rentang tanggal diminta, setiap baris respons akan berisi indeks rentang tanggal berbasis nol. Jika dua rentang tanggal tumpang-tindih, data peristiwa untuk hari-hari yang tumpang-tindih akan disertakan dalam baris respons untuk kedua rentang tanggal. Dalam permintaan kohor, dateRanges ini tidak boleh ditentukan.
dimensionFilter

object (FilterExpression)

Opsional. Dengan filter dimensi, Anda dapat meminta hanya nilai dimensi tertentu dalam laporan. Untuk mempelajari lebih lanjut, lihat Dasar-Dasar Filter Dimensi untuk melihat contoh. Metrik tidak dapat digunakan dalam filter ini.
metricFilter

object (FilterExpression)

Opsional. Klausa filter metrik. Diterapkan setelah menggabungkan baris laporan, mirip dengan klausa having SQL. Dimensi tidak dapat digunakan dalam filter ini.
offset

string (int64 format)

Opsional. Jumlah baris baris awal dari Penyimpanan Google Analytics. Baris pertama dihitung sebagai baris 0.

Saat membuat tugas laporan, parameter offset dan limit menentukan subkumpulan baris data dari penyimpanan Google Analytics yang akan disertakan dalam laporan yang dihasilkan. Misalnya, jika ada total 300.000 baris di penyimpanan Google Analytics, tugas laporan awal mungkin memiliki 10.000 baris pertama dengan batas 10.000 dan offset 0. Selanjutnya, tugas laporan lain dapat mencakup 10.000 baris berikutnya dengan batas 10.000 dan offset 10.000.
limit

string (int64 format)

Opsional. Jumlah baris yang akan ditampilkan dalam Laporan. Jika tidak ditentukan, 10.000 baris akan ditampilkan. API menampilkan maksimum 250.000 baris per permintaan, berapa pun jumlah yang Anda minta. limit harus positif.

API juga dapat menampilkan lebih sedikit baris daripada limit yang diminta, jika tidak ada nilai dimensi sebanyak limit. Misalnya, ada kurang dari 300 kemungkinan nilai untuk dimensi country, jadi saat melaporkan hanya country, Anda tidak bisa mendapatkan lebih dari 300 baris, meskipun Anda menetapkan limit ke nilai yang lebih tinggi.
metricAggregations[]

enum (MetricAggregation)

Opsional. Agregasi metrik. Nilai metrik gabungan akan ditampilkan di baris tempat dimensionValues ditetapkan ke "RESERVED_(MetricAggregation)".
orderBys[]

object (OrderBy)

Opsional. Menentukan cara baris diurutkan dalam respons.
currencyCode

string

Opsional. Kode mata uang dalam format ISO4217, seperti "AED", "USD", "JPY". Jika kolom kosong, laporan akan menggunakan mata uang default properti.
cohortSpec

object (CohortSpec)

Opsional. Grup kohor yang terkait dengan permintaan ini. Jika ada grup kohor dalam permintaan, dimensi 'kohor' harus ada.
keepEmptyRows

boolean

Opsional. Jika salah (false) atau tidak ditentukan, setiap baris dengan semua metrik sama dengan 0 tidak akan ditampilkan. Jika benar (true), baris ini akan ditampilkan jika tidak dihapus secara terpisah oleh filter.

Terlepas dari setelan keepEmptyRows ini, hanya data yang direkam oleh properti Google Analytics yang dapat ditampilkan dalam laporan.

Misalnya, jika properti tidak pernah mencatat peristiwa purchase, maka kueri untuk dimensi eventName dan metrik eventCount tidak akan memiliki baris yang berisi eventName: "purchase" dan eventCount: 0.
samplingLevel

enum (SamplingLevel)

Opsional. Tingkat pengambilan sampel laporan.

Dimensi

Dimensi merupakan atribut data Anda. Misalnya, dimensi kota menunjukkan kota asal peristiwa. Nilai dimensi dalam respons laporan adalah string; misalnya, kota bisa berupa "Paris" atau "New York".

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

string

Nama dimensi. Lihat Dimensi API untuk mengetahui daftar nama dimensi yang didukung oleh metode pelaporan inti seperti runReport dan batchRunReports. Lihat Dimensi Real-Time untuk mengetahui daftar nama dimensi yang didukung oleh metode runRealtimeReport. Lihat Dimensi Corong untuk mengetahui daftar nama dimensi yang didukung oleh metode runFunnelReport.

Jika dimensionExpression ditentukan, name dapat berupa string apa pun yang Anda inginkan dalam set karakter yang diizinkan. Misalnya, jika dimensionExpression menggabungkan country dan city, Anda dapat menyebut dimensi tersebut countryAndCity. Nama dimensi yang Anda pilih harus cocok dengan ekspresi reguler ^[a-zA-Z0-9_]$.

Dimensi dirujuk oleh name di dimensionFilter, orderBys, dimensionExpression, dan pivots.
dimensionExpression

object (DimensionExpression)

Satu dimensi dapat menjadi hasil ekspresi dari beberapa dimensi. Misalnya, dimensi "negara, kota": concatenate(negara, ", ", kota).

DimensionExpression

Digunakan untuk menyatakan dimensi yang merupakan hasil dari formula beberapa dimensi. Contoh penggunaan: 1) lowerCase(dimensi) 2) concatenate(dimensi1, simbol, dimensi2).

Representasi JSON 
{

  // 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.
}
Kolom
Kolom union one_expression. Tentukan satu jenis ekspresi dimensi untuk DimensionExpression. one_expression hanya dapat berupa salah satu dari hal berikut:
lowerCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi menjadi huruf kecil.
upperCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi menjadi huruf besar.
concatenate

object (ConcatenateExpression)

Digunakan untuk menggabungkan nilai dimensi ke dalam satu dimensi. Misalnya, dimensi "negara, kota": concatenate(negara, ", ", kota).

CaseExpression

Digunakan untuk mengonversi nilai dimensi ke satu huruf.

Representasi JSON 
{
  "dimensionName": string
}
Kolom
dimensionName

string

Nama dimensi. Nama harus merujuk kembali ke nama di kolom dimensi permintaan.

ConcatenateExpression

Digunakan untuk menggabungkan nilai dimensi ke dalam satu dimensi.

Representasi JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Kolom
dimensionNames[]

string

Nama dimensi. Nama harus merujuk kembali ke nama di kolom dimensi permintaan.
delimiter

string

Pemisah yang ditempatkan di antara nama dimensi.

Pembatas sering kali berupa karakter tunggal seperti "|" atau ",", tetapi dapat berupa string yang lebih panjang. Jika nilai dimensi berisi pembatas, keduanya akan ada dalam respons tanpa perbedaan. Misalnya, jika nilai dimensi 1 = "US,FR", nilai dimensi 2 = "JP", dan pemisah = ",", maka respons akan berisi "US,FR,JP".

Metrik

Pengukuran kuantitatif laporan. Misalnya, metrik eventCount adalah jumlah total peristiwa. Permintaan diizinkan hingga 10 metrik.

Representasi JSON 
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
Kolom
name

string

Nama metrik. Lihat Metrik API untuk mengetahui daftar nama metrik yang didukung oleh metode pelaporan inti seperti runReport dan batchRunReports. Lihat Metrik Real-Time untuk mengetahui daftar nama metrik yang didukung oleh metode runRealtimeReport. Lihat Metrik Funnel untuk mengetahui daftar nama metrik yang didukung oleh metode runFunnelReport.

Jika expression ditentukan, name dapat berupa string apa pun yang Anda inginkan dalam set karakter yang diizinkan. Misalnya, jika expression adalah screenPageViews/sessions, Anda dapat memanggil nama metrik tersebut = viewsPerSession. Nama metrik yang Anda pilih harus cocok dengan ekspresi reguler ^[a-zA-Z0-9_]$.

Metrik dirujuk oleh name di metricFilter, orderBys, dan metrik expression.
expression

string

Ekspresi matematika untuk metrik turunan. Misalnya, metrik Jumlah peristiwa per pengguna adalah eventCount/totalUsers.
invisible

boolean

Menunjukkan apakah metrik tidak terlihat dalam respons laporan. Jika metrik tidak terlihat, metrik tidak akan menghasilkan kolom dalam respons, tetapi dapat digunakan dalam metricFilter, orderBys, atau metrik expression.

DateRange

Kumpulan hari yang berurutan: startDate, startDate + 1, ..., endDate. Permintaan diizinkan hingga 4 rentang tanggal.

Representasi JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Kolom
startDate

string

Tanggal mulai inklusif untuk kueri dalam format YYYY-MM-DD. Tidak boleh setelah endDate. Format NdaysAgo, yesterday, atau today juga diterima, dan dalam hal ini, tanggal disimpulkan berdasarkan zona waktu pelaporan properti.
endDate

string

Tanggal akhir inklusif untuk kueri dalam format YYYY-MM-DD. Tidak boleh sebelum startDate. Format NdaysAgo, yesterday, atau today juga diterima, dan dalam hal ini, tanggal disimpulkan berdasarkan zona waktu pelaporan properti.
name

string

Menetapkan nama ke rentang tanggal ini. Dimensi dateRange diberi nilai nama ini dalam respons laporan. Jika disetel, tidak boleh diawali dengan date_range_ atau RESERVED_. Jika tidak ditetapkan, rentang tanggal diberi nama berdasarkan indeks berbasis nol dalam permintaan: date_range_0, date_range_1, dll.

FilterExpression

Untuk menyatakan filter dimensi atau metrik. Kolom dalam FilterExpression yang sama harus berupa semua dimensi atau semua metrik.

Representasi JSON 
{

  // 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.
}
Kolom
Kolom union expr. Tentukan satu jenis ekspresi filter untuk FilterExpression. expr hanya dapat berupa salah satu dari hal berikut:
andGroup

object (FilterExpressionList)

FilterExpressions di andGroup memiliki hubungan AND.
orGroup

object (FilterExpressionList)

FilterExpressions dalam orGroup memiliki hubungan OR.
notExpression

object (FilterExpression)

FilterExpression BUKAN notExpression.
filter

object (Filter)

Filter primitif. Dalam FilterExpression yang sama, semua nama kolom filter harus berupa semua dimensi atau semua metrik.

FilterExpressionList

Daftar ekspresi filter.

Representasi JSON 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Kolom
expressions[]

object (FilterExpression)

Daftar ekspresi filter.

Filter

Ekspresi untuk memfilter nilai dimensi atau metrik.

Representasi JSON 
{
  "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)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // End of list of possible types for union field one_filter.
}
Kolom
fieldName

string

Nama dimensi atau nama metrik. Harus berupa nama yang ditentukan dalam dimensi atau metrik.
Kolom union one_filter. Tentukan satu jenis filter untuk Filter. one_filter hanya dapat berupa salah satu dari hal berikut:
stringFilter

object (StringFilter)

Filter terkait string.
inListFilter

object (InListFilter)

Filter untuk nilai dalam daftar.
numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.
betweenFilter

object (BetweenFilter)

Filter untuk nilai di antara dua nilai.
emptyFilter

object (EmptyFilter)

Filter untuk nilai kosong seperti nilai "(not set)" dan "".

StringFilter

Filter untuk string

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

enum (MatchType)

Jenis pencocokan untuk filter ini.
value

string

Nilai string yang digunakan untuk pencocokan.
caseSensitive

boolean

Jika benar, nilai string peka huruf besar/kecil.

MatchType

Jenis pencocokan filter string

Enum
MATCH_TYPE_UNSPECIFIED Tidak ditentukan
EXACT Pencocokan persis nilai string.
BEGINS_WITH Dimulai dengan nilai string.
ENDS_WITH Diakhiri dengan nilai string.
CONTAINS Berisi nilai string.
FULL_REGEXP Pencocokan penuh untuk ekspresi reguler dengan nilai string.
PARTIAL_REGEXP Pencocokan sebagian untuk ekspresi reguler dengan nilai string.

InListFilter

Hasilnya harus berupa daftar nilai string.

Representasi JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Kolom
values[]

string

Daftar nilai string. Tidak boleh kosong.
caseSensitive

boolean

Jika benar, nilai string peka huruf besar/kecil.

NumericFilter

Memfilter nilai numerik atau tanggal.

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

enum (Operation)

Jenis operasi untuk filter ini.
value

object (NumericValue)

Nilai numerik atau nilai tanggal.

Operasi

Operasi yang diterapkan ke filter numerik

Enum
OPERATION_UNSPECIFIED Tidak ditentukan.
EQUAL Sama dengan
LESS_THAN Kurang dari
LESS_THAN_OR_EQUAL Kurang dari atau sama dengan
GREATER_THAN Lebih dari
GREATER_THAN_OR_EQUAL Lebih dari atau sama dengan

NumericValue

Untuk merepresentasikan angka.

Representasi JSON 
{

  // 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.
}
Kolom
Kolom union one_value. Salah satu nilai numerik one_value hanya dapat berupa salah satu dari berikut:
int64Value

string (int64 format)

Nilai bilangan bulat
doubleValue

number

Nilai ganda

BetweenFilter

Untuk menyatakan bahwa hasilnya harus berada di antara dua angka (inklusif).

Representasi JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Kolom
fromValue

object (NumericValue)

Dimulai dengan angka ini.
toValue

object (NumericValue)

Berakhir dengan angka ini.

EmptyFilter

Jenis ini tidak memiliki kolom.

Memfilter nilai kosong.

MetricAggregation

Mewakili agregasi metrik.

Enum
METRIC_AGGREGATION_UNSPECIFIED Operator tidak ditentukan.
TOTAL Operator SUM.
MINIMUM Operator minimum.
MAXIMUM Operator maksimum.
COUNT Operator penghitungan.

OrderBy

Pengurutan menurut menentukan cara pengurutan baris dalam respons. Misalnya, mengurutkan baris berdasarkan jumlah peristiwa menurun adalah satu pengurutan, dan mengurutkan baris berdasarkan string nama peristiwa adalah pengurutan yang berbeda.

Representasi JSON 
{
  "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.
}
Kolom
desc

boolean

Jika benar, urutkan dari atas ke bawah.
Kolom union one_order_by. Tentukan satu jenis pengurutan menurut untuk OrderBy. one_order_by hanya dapat berupa salah satu dari hal berikut:
metric

object (MetricOrderBy)

Mengurutkan hasil menurut nilai metrik.
dimension

object (DimensionOrderBy)

Mengurutkan hasil menurut nilai dimensi.

MetricOrderBy

Mengurutkan menurut nilai metrik.

Representasi JSON 
{
  "metricName": string
}
Kolom
metricName

string

Nama metrik dalam permintaan untuk mengurutkan menurut.

DimensionOrderBy

Mengurutkan menurut nilai dimensi.

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

string

Nama dimensi dalam permintaan untuk mengurutkan menurut.
orderType

enum (OrderType)

Mengontrol aturan untuk pengurutan nilai dimensi.

OrderType

Aturan untuk mengurutkan nilai dimensi string.

Enum
ORDER_TYPE_UNSPECIFIED Tidak ditentukan.
ALPHANUMERIC Pengurutan alfanumerik berdasarkan poin kode Unicode. Misalnya, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Pengurutan alfanumerik yang tidak peka huruf besar/kecil berdasarkan poin kode Unicode huruf kecil. Misalnya, "2" < "A" < "b" < "X" < "z".
NUMERIC Nilai dimensi dikonversi menjadi angka sebelum diurutkan. Misalnya, dalam pengurutan NUMERIK, "25" < "100", dan dalam pengurutan ALPHANUMERIC, "100" < "25". Semua nilai dimensi non-numerik memiliki nilai pengurutan yang sama di bawah semua nilai numerik.

CohortSpec

Spesifikasi kelompok untuk laporan kelompok.

Laporan kelompok membuat deret waktu retensi pengguna untuk kelompok. Misalnya, Anda dapat memilih kelompok pengguna yang diperoleh pada minggu pertama bulan September dan mengikuti kelompok tersebut selama enam minggu berikutnya. Pemilihan pengguna yang diperoleh dalam kelompok minggu pertama bulan September ditentukan dalam objek cohort. Mengikuti kohor tersebut selama enam minggu berikutnya ditentukan dalam objek cohortsRange.

Untuk contoh, lihat Contoh Laporan Kelompok.

Respons laporan dapat menampilkan deret waktu mingguan yang menunjukkan bahwa aplikasi Anda telah mempertahankan 60% kohor ini setelah tiga minggu dan 25% kohor ini setelah enam minggu. Kedua persentase ini dapat dihitung dengan metrik cohortActiveUsers/cohortTotalUsers dan akan menjadi baris terpisah dalam laporan.

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

object (Cohort)

Menentukan kriteria pemilihan untuk mengelompokkan pengguna ke dalam kohor.

Sebagian besar laporan kelompok hanya menentukan satu kelompok. Jika beberapa kohor ditentukan, setiap kohor dapat dikenali dalam laporan berdasarkan namanya.
cohortsRange

object (CohortsRange)

Laporan kelompok mengikuti kelompok selama rentang tanggal pelaporan yang diperpanjang. Rentang ini menentukan durasi offset untuk mengikuti kohor.
cohortReportSettings

object (CohortReportSettings)

Setelan opsional untuk laporan kohor.

Kelompok

Menentukan kriteria pemilihan kelompok. Kelompok adalah sekumpulan pengguna yang memiliki karakteristik yang sama. Misalnya, pengguna dengan firstSessionDate yang sama termasuk dalam kelompok yang sama.

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

string

Menetapkan nama ke kelompok ini. Dimensi cohort diberi nilai nama ini dalam respons laporan. Jika disetel, tidak boleh diawali dengan cohort_ atau RESERVED_. Jika tidak disetel, kohor diberi nama berdasarkan indeks berbasis nol cohort_0, cohort_1, dll.
dimension

string

Dimensi yang digunakan oleh kelompok. Wajib dan hanya mendukung firstSessionDate.
dateRange

object (DateRange)

Kohor memilih pengguna yang tanggal sentuhan pertamanya berada di antara tanggal mulai dan tanggal akhir yang ditentukan dalam dateRange. dateRange ini tidak menentukan rentang tanggal lengkap data peristiwa yang ada dalam laporan kohor. Dalam laporan kohor, dateRange ini diperluas berdasarkan perincian dan offset yang ada di cohortsRange; data peristiwa untuk rentang tanggal pelaporan yang diperluas ada dalam laporan kohor.

Dalam permintaan kohor, dateRange ini diperlukan dan dateRanges dalam RunReportRequest atau RunPivotReportRequest harus tidak ditentukan.

dateRange ini umumnya harus selaras dengan perincian kohor. Jika CohortsRange menggunakan perincian harian, dateRange ini dapat berupa satu hari. Jika CohortsRange menggunakan perincian mingguan, dateRange ini dapat diselaraskan dengan batas minggu, dimulai pada hari Minggu dan berakhir pada hari Sabtu. Jika CohortsRange menggunakan perincian bulanan, dateRange ini dapat diselaraskan dengan bulan, dimulai pada hari pertama dan berakhir pada hari terakhir bulan.

CohortsRange

Mengonfigurasi rentang tanggal pelaporan yang diperluas untuk laporan kohor. Menentukan durasi offset untuk mengikuti kohor.

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

enum (Granularity)

Wajib. Tingkat perincian yang digunakan untuk menafsirkan startOffset dan endOffset untuk rentang tanggal pelaporan yang diperpanjang untuk laporan kohor.
startOffset

integer

startOffset menentukan tanggal mulai rentang tanggal pelaporan yang diperpanjang untuk laporan kohor. startOffset biasanya disetel ke 0 agar laporan berisi data dari akuisisi kohor ke depan.

Jika granularity adalah DAILY, startDate rentang tanggal pelaporan yang diperpanjang adalah startDate kelompok ditambah startOffset hari.

Jika granularity adalah WEEKLY, startDate rentang tanggal pelaporan yang diperpanjang adalah startDate kelompok ditambah startOffset * 7 hari.

Jika granularity adalah MONTHLY, startDate rentang tanggal pelaporan yang diperpanjang adalah startDate kelompok ditambah startOffset * 30 hari.
endOffset

integer

Wajib. endOffset menentukan tanggal akhir rentang tanggal pelaporan yang diperpanjang untuk laporan kohor. endOffset dapat berupa bilangan bulat positif apa pun, tetapi biasanya ditetapkan ke 5 hingga 10 agar laporan berisi data tentang kohor untuk beberapa jangka waktu perincian berikutnya.

Jika granularity adalah DAILY, endDate rentang tanggal pelaporan yang diperpanjang adalah endDate kelompok ditambah endOffset hari.

Jika granularity adalah WEEKLY, endDate rentang tanggal pelaporan yang diperpanjang adalah endDate kelompok ditambah endOffset * 7 hari.

Jika granularity adalah MONTHLY, endDate rentang tanggal pelaporan yang diperpanjang adalah endDate kelompok ditambah endOffset * 30 hari.

Perincian

Tingkat perincian yang digunakan untuk menafsirkan startOffset dan endOffset untuk rentang tanggal pelaporan yang diperpanjang untuk laporan kohor.

Enum
GRANULARITY_UNSPECIFIED Tidak boleh ditentukan.
DAILY Perincian harian. Umumnya digunakan jika dateRange kohor adalah satu hari dan permintaan berisi cohortNthDay.
WEEKLY Perincian mingguan. Umumnya digunakan jika dateRange kohor berdurasi satu minggu (dimulai pada hari Minggu dan berakhir pada hari Sabtu) dan permintaan berisi cohortNthWeek.
MONTHLY Perincian bulanan. Umumnya digunakan jika dateRange kohor berdurasi satu bulan dan permintaan berisi cohortNthMonth.

CohortReportSettings

Setelan opsional laporan kohor.

Representasi JSON 
{
  "accumulate": boolean
}
Kolom
accumulate

boolean

Jika benar, mengumpulkan hasil dari hari sentuhan pertama hingga hari akhir. Tidak didukung di RunReportRequest.

SamplingLevel

Kategori tingkat pengambilan sampel untuk permintaan.

Enum
SAMPLING_LEVEL_UNSPECIFIED Jenis tidak ditentukan.
LOW Menerapkan tingkat pengambilan sampel 10 juta untuk properti standar dan 100 juta untuk properti Google Analytics 360.
MEDIUM Khusus untuk properti Google Analytics 360 dengan tingkat pengambilan sampel 1 miliar.
UNSAMPLED Khusus untuk properti Google Analytics 360. Eksplorasi tanpa sampel lebih akurat dan dapat mengungkapkan insight yang tidak terlihat dalam eksplorasi standar. Untuk mempelajari lebih lanjut, lihat https://support.google.com/analytics/answer/10896953.

ReportMetadata

Metadata laporan untuk tugas laporan tertentu.

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

integer

Hanya output. Jumlah total token kuota yang ditagih selama pembuatan laporan. Karena jumlah token ini didasarkan pada aktivitas dari status CREATING, biaya token ini akan tetap setelah tugas laporan memasuki status ACTIVE atau FAILED.
state

enum (State)

Hanya output. Status saat ini untuk tugas laporan ini.
beginCreatingTime

string (Timestamp format)

Hanya output. Waktu saat reportTasks.create dipanggil dan laporan memulai status CREATING.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
taskRowCount

integer

Hanya output. Jumlah total baris dalam hasil laporan. Kolom ini akan diisi saat status aktif. Anda dapat memanfaatkan taskRowCount untuk penomoran halaman dalam batas laporan yang ada.
errorMessage

string

Hanya output. Pesan error akan muncul jika tugas laporan gagal selama pembuatan.
totalRowCount

integer

Hanya output. Jumlah total baris dalam penyimpanan Google Analytics. Jika ingin membuat kueri baris data tambahan di luar laporan saat ini, mereka dapat memulai tugas laporan baru berdasarkan totalRowCount.

taskRowCount mewakili jumlah baris yang secara khusus berkaitan dengan laporan saat ini, sedangkan totalRowCount mencakup jumlah total baris di semua data yang diambil dari penyimpanan Google Analytics.

Misalnya, taskRowCount laporan saat ini adalah 20, yang menampilkan data dari 20 baris pertama. Secara bersamaan, totalRowCount adalah 30, yang menunjukkan adanya data untuk semua 30 baris. taskRowCount dapat digunakan untuk melakukan penomoran halaman melalui 20 baris awal. Untuk memperluas laporan dan menyertakan data dari semua 30 baris, tugas laporan baru dapat dibuat menggunakan totalRowCount untuk mengakses kumpulan data lengkap senilai 30 baris.

Negara Bagian

Status pemrosesan.

Enum
STATE_UNSPECIFIED Status yang tidak ditentukan tidak akan pernah digunakan.
CREATING Laporan saat ini sedang dibuat dan akan tersedia pada masa mendatang. Pembuatan terjadi segera setelah panggilan CreateReport.
ACTIVE Laporan telah sepenuhnya dibuat dan siap dikueri.
FAILED Laporan gagal dibuat.

Metode

create

 Memulai pembuatan tugas laporan.

get

 Mendapatkan metadata laporan tentang tugas laporan tertentu.

list

 Mencantumkan semua tugas laporan untuk properti.

query

 Mengambil konten tugas pelaporan.