REST Resource: properties.reportTasks

Zasób: ReportTask

Konfiguracja konkretnego zadania dotyczącego raportu.

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

string

Tylko dane wyjściowe. Identyfikator. Nazwa zasobu zadania raportu przypisanego podczas tworzenia. Format: „properties/{property}/reportTasks/{reportTask}”
reportDefinition

object (ReportDefinition)

Opcjonalnie: Definicja raportu służąca do pobierania danych raportu, która opisuje strukturę raportu. Zwykle zawiera ona pola, które mają być uwzględnione w raporcie, oraz kryteria, które mają służyć do filtrowania danych.
reportMetadata

object (ReportMetadata)

Tylko dane wyjściowe. Metadane raportu dotyczące konkretnego zadania związanego z raportami, które zawierają informacje o raporcie. Zwykle zawiera te informacje: nazwę zasobu raportu, stan raportu, sygnaturę czasową jego utworzenia itp.

ReportDefinition

Definicja sposobu generowania raportu.

Zapis 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)
}
Pola
dimensions[]

object (Dimension)

Opcjonalnie: Wymiary żądane i wyświetlane.
metrics[]

object (Metric)

Opcjonalnie: Dane, które mają być wyświetlane.
dateRanges[]

object (DateRange)

Opcjonalnie: Zakresy dat danych do odczytu. Jeśli zostanie podany zakres dat, każdy wiersz odpowiedzi będzie zawierać indeks zakresu dat oparty na 0. Jeśli 2 zakresy dat się pokrywają, dane o zdarzeniach z nachodzących na siebie dni są uwzględniane w wierszach odpowiedzi dla obu zakresów dat. W prośbie o dane dotyczące kohorty nie można podać wartości parametru dateRanges.
dimensionFilter

object (FilterExpression)

Opcjonalnie: Filtry wymiarów umożliwiają wyświetlanie w raporcie tylko określonych wartości wymiarów. Więcej informacji i przykłady znajdziesz w artykule Podstawy filtrów wymiarów. W tym filtrze nie można używać danych.
metricFilter

object (FilterExpression)

Opcjonalnie: Klauzula filtra danych. Stosuje się go po zsumowaniu wierszy raportu, podobnie jak w przypadku klauzuli having w SQL. W tym filtrze nie można używać wymiarów.
offset

string (int64 format)

Opcjonalnie: Liczba wierszy w wierszu początkowym z magazynu danych Google Analytics. Pierwszy wiersz jest liczony jako wiersz 0.

Podczas tworzenia zadania związanego z raportami parametry offset i limit definiują podzbiór wierszy danych z magazynu Google Analytics, który ma być uwzględniony w wygenerowanym raporcie. Jeśli np. w magazynie Google Analytics jest łącznie 300 tys. wierszy, zadanie początkowego raportu może zawierać pierwsze 10 tys. wierszy z limitem 10 tys. i przesunięciem 0. Kolejne zadanie raportu może obejmować kolejne 10 tys. wierszy z limitem 10 tys. i przesunięciem 10 tys.
limit

string (int64 format)

Opcjonalnie: Liczba wierszy do zwrócenia w raporcie. Jeśli nie podasz tej wartości, zwróci się 10 tys. wierszy. Interfejs API zwraca maksymalnie 250 tys. wierszy na żądanie,niezależnie od tego, o ile prosisz. Wartość limit musi być dodatnia.

Interfejs API może też zwrócić mniej wierszy niż żądana liczba limit, jeśli nie ma tylu wartości wymiarów, ile wynosi parametr limit. Na przykład w przypadku wymiaru country jest mniej niż 300 możliwych wartości, więc w raportach dotyczących tylko wymiaru country nie możesz uzyskać więcej niż 300 wierszy, nawet jeśli ustawisz większą wartość dla wymiaru limit.
metricAggregations[]

enum (MetricAggregation)

Opcjonalnie: agregacja danych, Uwzględnione wartości danych będą wyświetlane w wierszach, w których wartości wymiarów mają ustawienie „RESERVED_(MetricAggregation)”.
orderBys[]

object (OrderBy)

Opcjonalnie: Określa sposób sortowania wierszy w odpowiedzi.
currencyCode

string

Opcjonalnie: Kod waluty w formacie ISO 4217, np. „AED”, „USD” lub „JPY”. Jeśli pole jest puste, raport używa domyślnej waluty usługi.
cohortSpec

object (CohortSpec)

Opcjonalnie: Grupa kohorty powiązana z tym żądaniem. Jeśli w żądaniu występuje grupa kohorty, musi być podany wymiar „cohorta”.
keepEmptyRows

boolean

Opcjonalnie: Jeśli wartość jest równa fałsz lub nie jest określona, nie zostanie zwrócony żaden wiersz, w którym wszystkie dane mają wartość 0. Jeśli to pole ma wartość Prawda, zwrócone zostaną te wiersze, które nie zostały usunięte przez filtr.

Niezależnie od tego ustawienia keepEmptyRows w raporcie mogą być wyświetlane tylko dane zarejestrowane przez usługę Google Analytics.

Jeśli np. usługa nigdy nie rejestruje zdarzenia purchase, zapytanie o wymiar eventName i dane eventCount nie będzie zawierać wiersza zawierającego kolumnę eventName z wartością „purchase” (zakup) i kolumnę eventCount z wartością 0.
samplingLevel

enum (SamplingLevel)

Opcjonalnie: Poziom próbkowania raportu.

Wymiar

Wymiary to atrybuty danych. Na przykład wymiar Miasto określa miasto, z którego pochodzi zdarzenie. Wartości wymiarów w odpowiedziach na raporty to ciągi znaków. Na przykład miasto może być „Paryż” lub „Nowy Jork”.

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

string

Nazwa wymiaru. Lista nazw wymiarów obsługiwanych przez podstawowe metody raportowania, takie jak runReport i batchRunReports, znajduje się w artykule Wymiary API. Listę nazw wymiarów obsługiwanych przez metodę runRealtimeReport znajdziesz w sekcji Wymiary w czasie rzeczywistym. Listę nazw wymiarów obsługiwanych przez metodę runFunnelReport znajdziesz w sekcji Wymiary ścieżki.

Jeśli określono parametr dimensionExpression, parametr name może zawierać dowolny ciąg znaków z dozwolonego zestawu znaków. Jeśli np. dimensionExpression łączy country i city, możesz nazwać ten wymiar countryAndCity. Wybrane nazwy wymiarów muszą być zgodne z wyrażeniem regularnym ^[a-zA-Z0-9_]$.

Wymiary są wskazywane przez name w dimensionFilter, orderBys, dimensionExpression i pivots.
dimensionExpression

object (DimensionExpression)

Jeden wymiar może być wynikiem wyrażenia wielu wymiarów. Na przykład wymiar „kraj, miasto”: concatenate(country, ", ", city).

DimensionExpression

Służy do wyrażenia wymiaru, który jest wynikiem formuły zawierającej wiele wymiarów. Przykłady użycia: 1) małePisma(wymiar) 2) konkatenuj(wymiar1, symbol, wymiar2).

Zapis 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.
}
Pola
Pole unii one_expression. W przypadku DimensionExpression wskaż jeden typ wyrażenia wymiaru. one_expression może być tylko jednym z tych elementów:
lowerCase

object (CaseExpression)

Służy do konwertowania wartości wymiaru na małe litery.
upperCase

object (CaseExpression)

Służy do zamiany wartości wymiaru na wielką literę.
concatenate

object (ConcatenateExpression)

Służy do łączenia wartości wymiarów w jeden wymiar. Na przykład wymiar „kraj, miasto”: concatenate(country, ", ", city).

CaseExpression

Służy do konwertowania wartości wymiaru na wielkość pojedynczą.

Zapis JSON 
{
  "dimensionName": string
}
Pola
dimensionName

string

Nazwa wymiaru. Nazwa musi się odnosić do nazwy w polu wymiarów żądania.

ConcatenateExpression

Służy do łączenia wartości wymiarów w jeden wymiar.

Zapis JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Pola
dimensionNames[]

string

nazwy wymiarów; Nazwy muszą się odnosić do nazw w polu „Wymiary” żądania.
delimiter

string

separator umieszczany między nazwami wymiarów.

Separatory to często pojedyncze znaki, np. „|” lub „,”, ale mogą to być też dłuższe ciągi znaków. Jeśli wartość wymiaru zawiera separator, w odpowiedzi będą obecne oba znaki bez żadnej różnicy. Jeśli np. wartość wymiaru 1 = „US,FR”, wartość wymiaru 2 = „JP”, a rozdzielacz = „,”, odpowiedź będzie zawierać ciąg „US,FR,JP”.

Dane

Ilościowe pomiary w raporcie. Na przykład dane eventCount to łączna liczba zdarzeń. W żądaniu można podać maksymalnie 10 danych.

Zapis JSON 
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
Pola
name

string

Nazwa rodzaju danych. Listę nazw danych obsługiwanych przez podstawowe metody raportowania, takie jak runReport i batchRunReports, znajdziesz w artykule Dane API. Aby zobaczyć listę nazw danych obsługiwanych przez metodę runRealtimeReport, zapoznaj się z artykułem Dane w czasie rzeczywistym. Lista nazw danych obsługiwanych przez metodę runFunnelReport znajduje się w sekcji Dane ścieżki.

Jeśli określono parametr expression, parametr name może zawierać dowolny ciąg znaków z dozwolonego zestawu znaków. Jeśli np. expression to screenPageViews/sessions, możesz nazwać te dane „= viewsPerSession”. Wybrane nazwy danych muszą być zgodne z wyrażeniem regularnym ^[a-zA-Z0-9_]$.

Dane są odwoływane za pomocą parametru name w modelu metricFilter, orderBys i danych expression.
expression

string

Wyrażenie matematyczne danych pochodnych. Na przykład dane Liczba zdarzeń na użytkownika to eventCount/totalUsers.
invisible

boolean

Wskazuje, czy dane są niewidoczne w odpowiedzi na raport. Jeśli dane są niewidoczne, nie będą generować kolumny w odpowiedzi, ale można ich używać w elementach metricFilter, orderBys lub danych expression.

Zakres dat

ciągły zbiór dni: startDate, startDate + 1, …, endDate. W prośbach można podać maksymalnie 4 zakresy dat.

Zapis JSON 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Pola
startDate

string

Data rozpoczęcia zapytania w formacie YYYY-MM-DD. Nie może być późniejsza niż endDate. Akceptowany jest też format NdaysAgo, yesterday lub today. W takim przypadku data jest określana na podstawie strefy czasowej usługi.
endDate

string

Data zakończenia zapytania w tym sensie, że jest uwzględniona w tym dniu (format YYYY-MM-DD). Nie może być wcześniejsza niż startDate. Akceptowany jest też format NdaysAgo, yesterday lub today. W takim przypadku data jest określana na podstawie strefy czasowej usługi.
name

string

Przypisuje nazwę do tego zakresu dat. Wymiar dateRange ma w odpowiedzi na raport tę nazwę. Jeśli jest ustawiony, nie może się zaczynać od date_range_ ani RESERVED_. Jeśli nie są ustawione, zakresy dat są nazywane w żądaniu według indeksu opartego na 0: date_range_0, date_range_1 itd.

FilterExpression

Do wyrażania filtrów wymiarów lub danych. Pola w tym samym wyrażeniu filtra muszą być albo wszystkimi wymiarami, albo wszystkimi danymi.

Zapis 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.
}
Pola
Pole unii expr. W przypadku FilterExpression określ jeden typ wyrażenia filtra. expr może być tylko jednym z tych elementów:
andGroup

object (FilterExpressionList)

Wyrażenia filtra w grupie AND są ze sobą powiązane operatorem ORAZ.
orGroup

object (FilterExpressionList)

Wyrażenia filtra w grupie OR są powiązane relacją LUB.
notExpression

object (FilterExpression)

Wyrażenie filtra NIE jest wyrażeniem nie.
filter

object (Filter)

Filtr prymitywny. W tym samym wyrażeniu filtra wszystkie nazwy pól filtra muszą być albo wszystkimi wymiarami, albo wszystkimi rodzajami danych.

FilterExpressionList

Lista wyrażeń filtra.

Zapis JSON 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Pola
expressions[]

object (FilterExpression)

Lista wyrażeń filtra.

Filtr

Wyrażenie służące do filtrowania wartości wymiarów lub danych.

Zapis 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.
}
Pola
fieldName

string

Nazwa wymiaru lub nazwa danych. Musi to być nazwa zdefiniowana w wymiarach lub danych.
Pole unii one_filter. W przypadku Filter określ jeden typ filtra. one_filter może być tylko jednym z tych elementów:
stringFilter

object (StringFilter)

Filtr powiązany z ciągiem znaków.
inListFilter

object (InListFilter)

Filtr według wartości w liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtrowanie wartości między 2 wartościami.
emptyFilter

object (EmptyFilter)

Filtr dla pustych wartości, np. „(nie ustawiono)” i „”.

StringFilter

Filtr dla ciągu znaków

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

enum (MatchType)

Typ dopasowania tego filtra.
value

string

Wartość ciągu używana do dopasowywania.
caseSensitive

boolean

Jeśli ma wartość true, wielkość liter w ciągu znaków jest rozróżniana.

MatchType

Typ dopasowania filtra ciągu znaków

Wartości w polu enum
MATCH_TYPE_UNSPECIFIED Nie określono
EXACT Dopasowanie ścisłe do wartości ciągu znaków.
BEGINS_WITH zaczyna się od ciągu znaków;
ENDS_WITH Kończy się wartością ciągu znaków.
CONTAINS Zawiera wartość ciągu znaków.
FULL_REGEXP Dopasowanie pełne wyrażenia regularnego do wartości ciągu znaków.
PARTIAL_REGEXP Dopasowanie częściowe wyrażenia regularnego do wartości ciągu znaków.

InListFilter

Wynik musi być listą wartości ciągu znaków.

Zapis JSON 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Pola
values[]

string

Lista wartości ciągu tekstowego. Nie może być puste.
caseSensitive

boolean

Jeśli ma wartość true, wielkość liter w ciągu znaków jest rozróżniana.

NumericFilter

Filtry według wartości liczbowych lub dat.

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

enum (Operation)

Typ operacji dla tego filtra.
value

object (NumericValue)

Wartość liczbowa lub data.

Operacja

Operacja zastosowana do filtra liczbowego

Wartości w polu enum
OPERATION_UNSPECIFIED Nie określono.
EQUAL Równa się
LESS_THAN To mniej niż
LESS_THAN_OR_EQUAL Mniejsze lub równe
GREATER_THAN To więcej niż
GREATER_THAN_OR_EQUAL Większe lub równe

NumericValue

do reprezentowania liczby;

Zapis 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.
}
Pola
Pole unii one_value. Wartość liczbowa one_value może mieć tylko jedną z tych wartości:
int64Value

string (int64 format)

Wartość w formie liczby całkowitej
doubleValue

number

Podwójna wartość

BetweenFilter

Aby wyrazić, że wynik musi mieścić się między dwoma liczbami (włącznie).

Zapis JSON 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Pola
fromValue

object (NumericValue)

zaczyna się od tego numeru;
toValue

object (NumericValue)

Kończy się na tym numerze.

EmptyFilter

Ten typ nie ma pól.

Filtrowanie według pustych wartości.

MetricAggregation

Reprezentują one agregację danych.

Wartości w polu enum
METRIC_AGGREGATION_UNSPECIFIED Operator nieokreślony.
TOTAL Operator SUMA.
MINIMUM Operator minimum.
MAXIMUM Operator maksymalny.
COUNT Operator zliczania.

OrderBy

Sortowanie według określa, jak wiersze będą sortowane w odpowiedzi. Na przykład sortowanie wierszy według malejącej liczby zdarzeń to jedno uporządkowanie, a sortowanie według ciągu znaków nazwy zdarzenia to inne uporządkowanie.

Zapis 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.
}
Pola
desc

boolean

Jeśli jest ustawiona na wartość Prawda, sortuje w kolejności malejącej.
Pole unii one_order_by. Określ jeden typ sortowania w przypadku kolumny OrderBy. one_order_by może być tylko jednym z tych elementów:
metric

object (MetricOrderBy)

Sortuje wyniki według wartości danych.
dimension

object (DimensionOrderBy)

Sortuje wyniki według wartości wymiaru.

MetricOrderBy

Sortowanie według wartości danych.

Zapis JSON 
{
  "metricName": string
}
Pola
metricName

string

Nazwa danych w prośbie, według których mają być one posortowane.

DimensionOrderBy

Sortuje według wartości wymiaru.

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

string

Nazwa wymiaru w pytaniu, według którego mają być sortowane dane.
orderType

enum (OrderType)

Określa regułę sortowania wartości wymiaru.

OrderType

Reguła służąca do sortowania wartości wymiaru ciągu znaków.

Wartości w polu enum
ORDER_TYPE_UNSPECIFIED Nie określono.
ALPHANUMERIC Sortowanie alfanumeryczne według punktu kodowego Unicode. Na przykład „2” < „A” < „X” < „b” < „z”.
CASE_INSENSITIVE_ALPHANUMERIC Sortowanie bez uwzględniania wielkości liter według znaków alfanumerycznych według małych liter w punkcie kodowym Unicode. Na przykład „2” < „A” < „b” < „X” < „z”.
NUMERIC Wartości wymiarów są konwertowane na liczby przed posortowaniem. Na przykład w sortowaniu NUMERYCZNYM „25” < „100”, a w sortowaniu ARYTMETYCZNYM „100” < „25”.ALPHANUMERIC Wartości wymiarów niebędących liczbami mają tę samą wartość sortowania niż wszystkie wartości liczbowe.

CohortSpec

Specyfikacja kohort na potrzeby raportu dotyczącego kohorty.

Raporty kohortowe tworzą serię czasową danych o utrzymaniu użytkowników w kohortach. Możesz na przykład wybrać grupę użytkowników pozyskanych w pierwszym tygodniu września i śledzić ją przez kolejne 6 tygodni. Wybór użytkowników pozyskanych w pierwszym tygodniu września jest określony w obiekcie cohort. Dane o tych grupach na kolejne 6 tygodni są podawane w obiekcie cohortsRange.

Przykłady znajdziesz w artykule Przykłady raportu dotyczącego kohorty.

Odpowiedź w raporcie może zawierać tygodniową serię czasową, w której np. po 3 tygodniach aplikacja zachowała 60% tej grupy odbiorców, a po 6 tygodniach – 25%. Te 2 wartości procentowe można obliczyć na podstawie danych cohortActiveUsers/cohortTotalUsers i będą one widoczne w raporcie w oddzielnych wierszach.

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

object (Cohort)

Określa kryteria wyboru użytkowników do grup.

Większość raportów dotyczących kohort definiuje tylko jedną kohortą. Jeśli zdefiniujesz kilka grup, każda z nich może być rozpoznawana w raporcie po nazwie.
cohortsRange

object (CohortsRange)

Raporty dotyczące kohorty obejmują kohorty w rozszerzonym zakresie dat raportowania. Ten zakres określa przesunięcie czasu, które ma być stosowane do grup odbiorców.
cohortReportSettings

object (CohortReportSettings)

Opcjonalne ustawienia raportu dotyczącego kohorty.

Kohorta

Określa kryteria wyboru kohorty. Kohorta jest grupą użytkowników mających wspólną cechę. Na przykład użytkownicy z tym samym firstSessionDate należą do tej samej kohorty.

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

string

Przypisuje nazwę tej kohorcie. Wymiar cohort ma w odpowiedzi na raport tę nazwę. Jeśli jest ustawiony, nie może się zaczynać od cohort_ ani RESERVED_. Jeśli nie zostanie ustawiony, kohorty będą nazywane według indeksu o wartości 0, cohort_0, cohort_1 itd.
dimension

string

Wymiar używany przez kohortę. Wymagane i obsługuje tylko firstSessionDate.
dateRange

object (DateRange)

Kohorta wybiera użytkowników, których data pierwszego kontaktu mieści się w zakresie daty rozpoczęcia i zakończenia zdefiniowanych w dateRange. W tym dateRange nie jest podany pełny zakres dat danych o zdarzeniach, które są dostępne w raporcie grup. W raporcie kohorty ten dateRange jest rozszerzony o poziom szczegółowości i odstęp występujący w raporcie cohortsRange. W raporcie kohorty są widoczne dane o zdarzeniach z rozszerzonego zakresu dat raportowania.

W żądaniu dotyczącej grupy musisz podać wartość dateRange, a wartość dateRanges w kolumnie RunReportRequest lub RunPivotReportRequest musi być nieokreślona.

Wartość dateRange powinna być dopasowana do szczegółowości kohorty. Jeśli CohortsRange używa szczegółowości na poziomie dni, ten dateRange może być pojedynczym dniem. Jeśli CohortsRange używa tygodniowej rozdzielczości, ta dateRange może być dopasowana do granicy tygodnia, rozpoczynając się w niedzielę i kończąc w sobotę. Jeśli CohortsRange używa granularności miesięcznej, ta dateRange może być dopasowana do miesiąca, rozpoczynając się pierwszego dnia i kończąc ostatniego dnia miesiąca.

CohortsRange

Konfiguruje rozszerzony zakres dat raportowania na potrzeby raportu dotyczącego kohorty. Określa przesunięcie długości okresu, w którym mają być śledzone kohorty.

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

enum (Granularity)

Wymagane. Dokładność, która służy do interpretacji wartości startOffset i endOffset w przypadku rozszerzonego zakresu dat raportowania w raporcie dotyczącym kohorty.
startOffset

integer

startOffset określa datę rozpoczęcia rozszerzonego zakresu dat raportowania w przypadku raportu dotyczącego kohorty. Wartość startOffset jest zwykle ustawiana na 0, aby raporty zawierały dane od momentu pozyskania kohorty.

Jeśli granularity to DAILY, startDate rozszerzonego zakresu dat raportowania to startDate kohorty plus startOffset dni.

Jeśli granularity to WEEKLY, startDate rozszerzonego zakresu dat raportowania to startDate kohorty plus startOffset * 7 dni.

Jeśli granularity to MONTHLY, startDate rozszerzonego zakresu dat raportowania to startDate kohorty plus startOffset * 30 dni.
endOffset

integer

Wymagane. endOffset określa datę końcową rozszerzonego zakresu dat raportowania w przypadku raportu dotyczącego grup odbiorców. Wartość endOffset może być dowolną dodatnią liczbą całkowitą, ale zwykle wynosi od 5 do 10, aby raporty zawierały dane o grupie użytkowników na kolejne okresy o zmiennej szczegółowości.

Jeśli granularity to DAILY, endDate rozszerzonego zakresu dat raportowania to endDate kohorty plus endOffset dni.

Jeśli granularity to WEEKLY, endDate rozszerzonego zakresu dat raportowania to endDate kohorty plus endOffset * 7 dni.

Jeśli granularity to MONTHLY, endDate rozszerzonego zakresu dat raportowania to endDate kohorty plus endOffset * 30 dni.

Szczegółowość

Dokładność, która służy do interpretacji wartości startOffset i endOffset w przypadku rozszerzonego zakresu dat raportowania w raporcie dotyczącym kohorty.

Wartości w polu enum
GRANULARITY_UNSPECIFIED Nigdy nie należy go podawać.
DAILY Szczegółowość dzienna. Jest często używana, jeśli dateRange w przypadku kohorty to 1 dzień, a żądanie zawiera cohortNthDay.
WEEKLY szczegółowość tygodniowa, Jest często używany, jeśli dateRange kohorty obejmuje tydzień (od niedzieli do soboty), a żądanie zawiera cohortNthWeek.
MONTHLY Miesięczny stopień szczegółowości. Jest często używany, jeśli dateRange kohorty trwa miesiąc, a żądanie zawiera cohortNthMonth.

CohortReportSettings

Opcjonalne ustawienia raportu dotyczącego kohorty.

Zapis JSON 
{
  "accumulate": boolean
}
Pola
accumulate

boolean

Jeśli ma wartość true, kumuluje wynik od dnia pierwszego kontaktu do dnia zakończenia. Nieobsługiwane w RunReportRequest.

SamplingLevel

Kategorie poziomów próbkowania żądań.

Wartości w polu enum
SAMPLING_LEVEL_UNSPECIFIED Nieokreślony typ.
LOW Stosuje próbkowanie na poziomie 10 mln w przypadku usług standardowych i 100 mln w przypadku usług w Google Analytics 360.
MEDIUM Dostępne tylko w usługach w Google Analytics 360 z poziomem próbkowania 1 mld.
UNSAMPLED Dostępne tylko w usługach w Google Analytics 360. Eksploracje niespróbkowane są dokładniejsze i mogą dostarczyć statystyk, które są niewidoczne w standardowych eksploracjach. Więcej informacji znajdziesz na stronie https://support.google.com/analytics/answer/10896953.

ReportMetadata

Metadane raportu dotyczące konkretnego zadania związanego z raportowaniem.

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

integer

Tylko dane wyjściowe. Łączna liczba tokenów limitu wykorzystana podczas tworzenia raportu. Ponieważ liczba tokenów jest określana na podstawie aktywności w stanie CREATING, opłata za tokeny będzie stała, gdy zadanie raportu wejdzie w stan ACTIVE lub FAILED.
state

enum (State)

Tylko dane wyjściowe. Bieżący stan tego zadania polegającego na wygenerowaniu raportu.
beginCreatingTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, o którym została wywołana metoda reportTasks.create, i czas, w którym raport zmienił stan na CREATING.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
taskRowCount

integer

Tylko dane wyjściowe. Łączna liczba wierszy w wyniku raportu. To pole zostanie wypełnione, gdy stan będzie aktywny. Możesz używać taskRowCount do podziału na strony w ramach istniejącego raportu.
errorMessage

string

Tylko dane wyjściowe. Jeśli podczas tworzenia zadania związanego z raportowaniem wystąpi błąd, zostanie wyświetlony komunikat o błędzie.
totalRowCount

integer

Tylko dane wyjściowe. Łączna liczba wierszy w magazynie Google Analytics. Jeśli chcesz zapytać o dodatkowe wiersze danych poza bieżącym raportem, możesz utworzyć nowe zadanie dotyczące raportu na podstawie totalRowCount.

Wartość taskRowCount to liczba wierszy należących do bieżącego raportu, a wartość totalRowCount to łączna liczba wierszy we wszystkich danych pobranych z magazynu Google Analytics.

Załóżmy na przykład, że taskRowCount w bieżącym raporcie ma wartość 20, co oznacza, że wyświetlane są dane z pierwszych 20 wierszy. Jednocześnie totalRowCount to 30, co oznacza, że dane są dostępne we wszystkich 30 wierszach. Parametru taskRowCount można używać do przewijania pierwszych 20 wierszy. Aby rozwinąć raport i uwzględnić dane ze wszystkich 30 wierszy, możesz utworzyć nowe zadanie raportu, używając parametru „totalRowCount” (łączna liczba wierszy), aby uzyskać dostęp do pełnego zbioru danych z 30 wierszy.

Stan

Stan przetwarzania.

Wartości w polu enum
STATE_UNSPECIFIED Stan nieokreślony nigdy nie będzie używany.
CREATING Raport jest obecnie tworzony i będzie dostępny w przyszłości. Tworzenie następuje natychmiast po wywołaniu CreateReport.
ACTIVE Raport jest w pełni utworzony i gotowy do tworzenia zapytań.
FAILED Nie udało się utworzyć raportu.

Metody

create

 Inicjowanie tworzenia zadania raportu.

get

 Pobiera metadane raportu dotyczące konkretnego zadania związanego z raportowaniem.

list

 Wyświetla wszystkie zadania związane z raportami dotyczącymi usługi.

query

 Pobiera treść zadania dotyczącego raportu.