REST Resource: properties.reportTasks

Zasób: ReportTask

Określona konfiguracja zadania raportu.

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

string

Tylko dane wyjściowe. Identyfikator. Nazwa zasobu zadania raportu przypisana 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 będą uwzględnione w raporcie, oraz kryteria, które będą używane do filtrowania danych.
reportMetadata

object (ReportMetadata)

Tylko dane wyjściowe. Metadane raportu dotyczące konkretnego zadania związanego z raportem, które zawierają informacje o raporcie. Zwykle zawiera te informacje: nazwę zasobu raportu, jego stan, sygnaturę czasową 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, o które poproszono i które zostały wyświetlone.
metrics[]

object (Metric)

Opcjonalnie: Żądane i wyświetlane dane.
dateRanges[]

object (DateRange)

Opcjonalnie: Zakresy dat danych do odczytania. Jeśli zostanie poproszonych kilka zakresów dat, każdy wiersz odpowiedzi będzie zawierać indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat nakładają się na siebie, dane zdarzenia z nakładających się dni są uwzględniane w wierszach odpowiedzi dla obu zakresów dat. W przypadku prośby o kohortę ten parametr dateRanges musi być nieokreślony.
dimensionFilter

object (FilterExpression)

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

object (FilterExpression)

Opcjonalnie: Klauzula filtra danych. Stosowany po agregacji wierszy raportu, podobnie jak klauzula 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 pamięci Google Analytics. Pierwszy wiersz jest liczony jako wiersz 0.

Podczas tworzenia zadania raportu parametry offset i limit określają podzbiór wierszy danych z pamięci Google Analytics, które mają być uwzględnione w wygenerowanym raporcie. Jeśli np. w pamięci Google Analytics jest łącznie 300 tys. wierszy, początkowe zadanie raportu może zawierać pierwsze 10 tys. wierszy z limitem 10 tys. i przesunięciem 0. Kolejne zadanie raportu może obejmować następne 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 tu żadnej wartości, zostanie zwróconych 10 tys. wierszy. Interfejs API zwraca maksymalnie 250 tys. wierszy na żądanie,niezależnie od tego, ile wierszy zażądasz. Wartość limit musi być dodatnia.

Interfejs API może też zwrócić mniej wierszy niż żądana wartość limit, jeśli nie ma tylu wartości wymiarów, ile wynosi limit. Na przykład wymiar country ma mniej niż 300 możliwych wartości, więc podczas generowania raportu tylko na podstawie tego wymiaru nie możesz uzyskać więcej niż 300 wierszy, nawet jeśli ustawisz wartość parametru limit na wyższą.country
metricAggregations[]

enum (MetricAggregation)

Opcjonalnie: Agregacja danych. Zagregowane wartości wskaźników będą wyświetlane w wierszach, w których parametr dimensionValues ma wartość „RESERVED_(MetricAggregation)”.
orderBys[]

object (OrderBy)

Opcjonalnie: Określa sposób uporządkowania wierszy w odpowiedzi.
currencyCode

string

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

object (CohortSpec)

Opcjonalnie: Grupa kohortowa powiązana z tym żądaniem. Jeśli w żądaniu znajduje się grupa kohort, musi być w nim obecny wymiar „kohorta”.
keepEmptyRows

boolean

Opcjonalnie: Jeśli wartość jest fałszywa lub nieokreślona, każdy wiersz, w którym wszystkie dane są równe 0, nie zostanie zwrócony. Jeśli wartość to „true”, te wiersze zostaną zwrócone, o ile nie zostaną osobno usunięte przez filtr.

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

Jeśli np. usługa nigdy nie rejestruje zdarzenia purchase, zapytanie o wymiar eventName i rodzaj danych eventCount nie będzie zawierać wiersza z wartościami eventName: „purchase” i eventCount: 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 raportów są ciągami znaków. Na przykład miasto może mieć wartość „Paryż” lub „Nowy Jork”.

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

string

Nazwa wymiaru. Listę nazw wymiarów obsługiwanych przez podstawowe metody raportowania, takie jak runReport i batchRunReports, znajdziesz w sekcji 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 artykule Wymiary ścieżki.

Jeśli podano dimensionExpression, name może być dowolnym ciągiem znaków z dozwolonego zestawu. 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ą określane przez name w dimensionFilter, orderBys, dimensionExpression i pivots.
dimensionExpression

object (DimensionExpression)

Jeden wymiar może być wynikiem wyrażenia obejmującego wiele wymiarów. Na przykład wymiar „kraj, miasto”: concatenate(kraj, „, ”, miasto).

DimensionExpression

Używany do wyrażania wymiaru, który jest wynikiem formuły obejmującej wiele wymiarów. Przykłady użycia: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
Pola
Określ 1 typ wyrażenia wymiaru dla DimensionExpression. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
lowerCase

object (CaseExpression)

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

object (CaseExpression)

Służy do przekształcania wartości wymiaru na wielkie litery.
concatenate

object (ConcatenateExpression)

Służy do łączenia wartości wymiarów w jeden wymiar. Na przykład wymiar „kraj, miasto”: concatenate(kraj, „, ”, miasto).
Koniec pól wykluczających się nawzajem.

CaseExpression

Służy do przekształcania wartości wymiaru na jeden rodzaj wielkości liter.

Zapis JSON 
{
  "dimensionName": string
}
Pola
dimensionName

string

Nazwa wymiaru. Nazwa musi odnosić się 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ą odnosić się do nazw w polu wymiarów żądania.
delimiter

string

Ogranicznik umieszczony między nazwami wymiarów.

Separatorami są 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ą widoczne oba elementy bez rozróżnienia. Jeśli np. wartość wymiaru 1 to „US,FR”, wartość wymiaru 2 to „JP”, a ogranicznik to „,”, odpowiedź będzie zawierać „US,FR,JP”.

Wskaźnik

Ilościowe wyniki pomiarów w raporcie. Na przykład dane eventCount to łączna liczba zdarzeń. W żądaniach można podać maksymalnie 10 rodzajów 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 sekcji Dane API. Listę nazw danych obsługiwanych przez metodę runRealtimeReport znajdziesz w artykule Dane w czasie rzeczywistym. Listę nazw danych obsługiwanych przez metodę runFunnelReport znajdziesz w artykule Dane dotyczące ścieżki.

Jeśli podano expression, name może być dowolnym ciągiem znaków z dozwolonego zestawu. Jeśli na przykład 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ą przywoływane przez name w metricFilter, orderBys i danych expression.
expression

string

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

boolean

Wskazuje, czy dane są niewidoczne w odpowiedzi raportu. Jeśli dane są niewidoczne, nie utworzą kolumny w odpowiedzi, ale można ich używać w funkcjach metricFilter, orderBys lub w danych expression.

Zakres dat

Ciągły zbiór dni: startDate, startDate + 1, ..., endDate. Żądania mogą obejmować maksymalnie 4 zakresy dat.

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

string

Data rozpoczęcia zapytania (włącznie z tym dniem) w formacie YYYY-MM-DD. Nie może przypadać po endDate. Akceptowane są też formaty NdaysAgo, yesterday i today. W takim przypadku data jest określana na podstawie strefy czasowej raportowania usługi.
endDate

string

Data zakończenia zapytania (włącznie z tym dniem) w formacie YYYY-MM-DD. Nie może przypadać przed startDate. Akceptowane są też formaty NdaysAgo, yesterday i today. W takim przypadku data jest określana na podstawie strefy czasowej raportowania usługi.
name

string

Przypisuje nazwę do tego zakresu dat. W odpowiedzi raportu wymiar dateRange ma wartość tej nazwy. Jeśli jest ustawiona, nie może zaczynać się od znaku date_range_ ani RESERVED_. Jeśli nie zostanie ustawiona, zakresy dat są nazywane na podstawie indeksu w żądaniu (liczonego od zera): date_range_0, date_range_1 itp.

FilterExpression

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

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of mutually exclusive fields.
}
Pola
Określ 1 typ wyrażenia filtra dla FilterExpression. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
andGroup

object (FilterExpressionList)

Elementy FilterExpression w andGroup są ze sobą powiązane operatorem AND.
orGroup

object (FilterExpressionList)

Wyrażenia filtra w orGroup są ze sobą powiązane operatorem LUB.
notExpression

object (FilterExpression)

Wartość FilterExpression nie jest typu notExpression.
filter

object (Filter)

Filtr podstawowy. W tym samym wyrażeniu filtra wszystkie nazwy pól filtra muszą być wymiarami lub danymi.
Koniec pól wykluczających się nawzajem.

FilterExpressionList

Lista wyrażeń filtra.

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

object (FilterExpression)

Lista wyrażeń filtra.

Filtruj

Wyrażenie do filtrowania wartości wymiarów lub danych.

Zapis JSON 
{
  "fieldName": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // End of mutually exclusive fields.
}
Pola
fieldName

string

Nazwa wymiaru lub danych. Musi to być nazwa zdefiniowana w wymiarach lub danych.
Określ jeden typ filtra dla Filter. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
stringFilter

object (StringFilter)

Filtr związany z ciągami znaków.
inListFilter

object (InListFilter)

Filtr wartości na liście.
numericFilter

object (NumericFilter)

Filtr wartości liczbowych lub dat.
betweenFilter

object (BetweenFilter)

Filtr dla wartości z zakresu.
emptyFilter

object (EmptyFilter)

filtr pustych wartości, np. wartości (not set) i "";
Koniec pól wykluczających się nawzajem.

StringFilter

Filtr ciągu tekstowego

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 wartość to „true”, wielkość liter w wartości ciągu znaków ma znaczenie.

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 wartości ciągu tekstowego.
ENDS_WITH kończy się wartością ciągu znaków.
CONTAINS Zawiera wartość w postaci ciągu znaków.
FULL_REGEXP Pełne dopasowanie wyrażenia regularnego do wartości ciągu tekstowego.
PARTIAL_REGEXP Częściowe dopasowanie wyrażenia regularnego do wartości ciągu tekstowego.

InListFilter

Wynik musi być listą wartości tekstowych.

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

string

Lista wartości ciągów tekstowych. Nie może być puste.
caseSensitive

boolean

Jeśli wartość to „true”, wielkość liter w wartości ciągu znaków ma znaczenie.

NumericFilter

Filtry 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 numerycznego

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

NumericValue

reprezentować liczbę.

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "int64Value": string,
  "doubleValue": number
  // End of mutually exclusive fields.
}
Pola
Wartość liczbowa. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
int64Value

string (int64 format)

Wartość w formie liczby całkowitej
doubleValue

number

Podwójna wartość
Koniec pól wykluczających się nawzajem.

BetweenFilter

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

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

object (NumericValue)

zaczyna się od tej liczby;
toValue

object (NumericValue)

kończy się tym numerem;

EmptyFilter

Ten typ nie ma pól.

Filtruj według pustych wartości. Pasuje do wartości wymiarów, które są wartościami "" lub (not set). Użyj tego filtra, aby dopasować wiersze z brakującymi lub nieuzupełnionymi wartościami wymiarów, albo połącz go z filtrem notExpression, aby wykluczyć je z raportu bez filtrowania osobno wartości "" i (not set).

MetricAggregation

Reprezentuje agregację danych.

Wartości w polu enum
METRIC_AGGREGATION_UNSPECIFIED Nieokreślony operator.
TOTAL Operator SUMA.
MINIMUM Operator minimum.
MAXIMUM Operator maksimum.
COUNT Operator Count.

OrderBy

Kryteria sortowania określają sposób sortowania wierszy w odpowiedzi. Na przykład porządkowanie wierszy według malejącej liczby zdarzeń to jedno porządkowanie, a porządkowanie wierszy według ciągu nazwy zdarzenia to inne porządkowanie.

Zapis JSON 
{
  "desc": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of mutually exclusive fields.
}
Pola
desc

boolean

Jeśli ma wartość Prawda, sortuje w kolejności malejącej.
Określ jeden typ zamówienia dla OrderBy. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
metric

object (MetricOrderBy)

Sortuje wyniki według wartości danych.
dimension

object (DimensionOrderBy)

Sortuje wyniki według wartości wymiaru.
Koniec pól wykluczających się nawzajem.

MetricOrderBy

Sortuje według wartości wskaźnika.

Zapis JSON 
{
  "metricName": string
}
Pola
metricName

string

Nazwa wskaźnika w żądaniu, według którego ma być przeprowadzane sortowanie.

DimensionOrderBy

Sortuje według wartości wymiarów.

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

string

Nazwa wymiaru w żądaniu, według którego ma zostać wykonane sortowanie.
orderType

enum (OrderType)

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

OrderType

Reguła, według której mają być porządkowane wartości wymiaru tekstowego.

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 alfanumeryczne bez rozróżniania wielkości liter według punktu kodowego Unicode małych liter. Na przykład „2” < „A” < „b” < „X” < „z”.
NUMERIC Wartości wymiarów są przed sortowaniem przekształcane w liczby. Na przykład w przypadku sortowania NUMERIC „25” < „100”, a w przypadku sortowania ALPHANUMERIC „100” < „25”. Wartości nienumeryczne wymiaru mają taką samą wartość porządkowania poniżej wszystkich wartości numerycznych.

CohortSpec

Specyfikacja kohort w raporcie dotyczącym kohorty.

Raporty dotyczące kohorty tworzą szereg czasowy utrzymania użytkowników w kohorcie. Możesz na przykład wybrać kohortę 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. Śledzenie tej kohorty przez kolejne 6 tygodni jest określone w obiekcie cohortsRange.

Przykłady znajdziesz w artykule Przykłady raportów dotyczących kohorty.

Odpowiedź raportu może zawierać tygodniowe dane szeregowe, z których wynika np., że po 3 tygodniach w przypadku Twojej aplikacji 60% użytkowników z tej kohorty nadal z niej korzysta, a po 6 tygodniach – 25%. Te 2 wartości procentowe można obliczyć za pomocą danych cohortActiveUsers/cohortTotalUsers. Będą one wyświetlane w raporcie w oddzielnych wierszach.

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

object (Cohort)

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

Większość raportów dotyczących kohorty definiuje tylko jedną kohortę. Jeśli podasz kilka kohort, każda z nich będzie rozpoznawana w raporcie po nazwie.
cohortsRange

object (CohortsRange)

Raporty dotyczące kohort śledzą kohorty w dłuższym okresie raportowania. Ten zakres określa czas przesunięcia, w którym śledzone są kohorty.
cohortReportSettings

object (CohortReportSettings)

Opcjonalne ustawienia raportu dotyczącego kohorty.

Kohorta

Określa kryteria wyboru kohorty. Kohorta to grupa 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ę do tej kohorty. W odpowiedzi raportu wymiar cohort ma wartość tej nazwy. Jeśli jest ustawiona, nie może zaczynać się od znaku cohort_ ani RESERVED_. Jeśli nie zostanie ustawiona, kohorty będą nazywane na podstawie indeksu zerowego cohort_0, cohort_1 itd.
dimension

string

Wymiar używany przez kohortę. Wymagany i obsługuje tylko wartość firstSessionDate.
dateRange

object (DateRange)

Kohorta wybiera użytkowników, których data pierwszego kontaktu mieści się w zakresie daty rozpoczęcia i daty zakończenia określonym w dateRange. Ten symbol dateRange nie określa pełnego zakresu dat danych zdarzeń, które są dostępne w raporcie dotyczącym kohorty. W raporcie kohortowym ten okres dateRange jest wydłużany o graniczność i przesunięcie występujące w cohortsRange. Dane o zdarzeniach z wydłużonego zakresu dat raportowania są dostępne w raporcie kohortowym.

W przypadku żądania dotyczącego kohorty ten parametr dateRange jest wymagany, a parametr dateRanges w parametrach RunReportRequest lub RunPivotReportRequest musi być nieokreślony.

Ten dateRange powinien być zwykle zgodny z poziomem szczegółowości kohorty. Jeśli CohortsRange korzysta z dokładności dziennej, ten dateRange może być pojedynczym dniem. Jeśli funkcja CohortsRange korzysta z tygodniowej szczegółowości, ten dateRange może być dopasowany do granicy tygodnia, zaczynając się w niedzielę, a kończąc w sobotę. Jeśli CohortsRange korzysta z miesięcznej szczegółowości, ten dateRange można dopasować do miesiąca, zaczynając od pierwszego i kończąc na ostatnim dniu miesiąca.

CohortsRange

Konfiguruje rozszerzony zakres dat raportowania w przypadku raportu dotyczącego kohorty. Określa czas przesunięcia, w którym mają być śledzone kohorty.

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

enum (Granularity)

Wymagane. Granularność używana do interpretowania 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 ma wartość DAILY, startDate rozszerzonego zakresu dat raportowania to startDate kohorty plus startOffset dni.

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

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

integer

Wymagane. endOffset określa datę zakończenia rozszerzonego zakresu dat raportowania w przypadku raportu dotyczącego kohorty. endOffset może być dowolną liczbą całkowitą, ale zwykle ustawia się ją na 5–10, aby raporty zawierały dane o kohorcie z kilku kolejnych okresów o określonej szczegółowości.

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

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

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

Szczegółowość

Granularność używana do interpretowania 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 określać.
DAILY Szczegółowość dzienna. Używane zwykle, gdy dateRange kohorty to jeden dzień, a żądanie zawiera parametr cohortNthDay.
WEEKLY Szczegółowość tygodniowa. Używane zwykle, gdy dateRange kohorty trwa tydzień (od niedzieli do soboty), a żądanie zawiera cohortNthWeek.
MONTHLY Miesięczny stopień szczegółowości. Używane zwykle, gdy 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 wartość to „true”, wynik jest sumowany 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 poziom próbkowania 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 wynoszącym 1 miliard.
UNSAMPLED Dostępne tylko w usługach w Google Analytics 360. Eksploracje niespróbkowane są dokładniejsze i mogą ujawniać statystyki, które są niewidoczne w standardowych eksploracjach. Więcej informacji znajdziesz na stronie https://support.google.com/analytics/answer/10896953.

ReportMetadata

Metadane raportu dla konkretnego zadania polegającego na wygenerowaniu raportu.

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 wykorzystanych podczas tworzenia raportu. Liczba tokenów jest obliczana na podstawie aktywności w stanie CREATING, więc opłata za tokeny będzie stała, gdy zadanie raportu przejdzie do stanu ACTIVE lub FAILED.
state

enum (State)

Tylko dane wyjściowe. Bieżący stan tego zadania związanego z raportem.
beginCreatingTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, w którym wywołano reportTasks.create, a raport osiągnął stan CREATING.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
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 paginacji w ramach istniejącego raportu.
errorMessage

string

Tylko dane wyjściowe. Jeśli podczas tworzenia zadania raportu wystąpi błąd, wyświetli się komunikat o błędzie.
totalRowCount

integer

Tylko dane wyjściowe. Łączna liczba wierszy w pamięci Google Analytics. Jeśli chcesz wysłać zapytanie o dodatkowe wiersze danych poza bieżącym raportem, możesz rozpocząć nowe zadanie raportu na podstawie totalRowCount.

Symbol taskRowCount oznacza liczbę wierszy odnoszących się konkretnie do bieżącego raportu, a symbol totalRowCount – łączną liczbę wierszy we wszystkich danych pobranych z pamięci Google Analytics.

Załóżmy na przykład, że bieżący raport ma wartość taskRowCount 20, co oznacza, że wyświetlane są dane z pierwszych 20 wierszy. Jednocześnie wartość totalRowCount wynosi 30, co oznacza, że dane są dostępne dla wszystkich 30 wierszy. Za pomocą taskRowCount możesz przechodzić między początkowymi 20 wierszami. Aby rozwinąć raport i uwzględnić dane ze wszystkich 30 wierszy, możesz utworzyć nowe zadanie raportu, używając parametru totalRowCount, aby uzyskać dostęp do pełnego zestawu 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 funkcji CreateReport.
ACTIVE Raport jest w pełni utworzony i gotowy do wysyłania zapytań.
FAILED Nie udało się utworzyć raportu.

Metody

create

 Inicjuje tworzenie zadania raportu.

get

 Pobiera metadane raportu dotyczące konkretnego zadania raportu.

list

 Wyświetla listę wszystkich zadań związanych z raportami w usłudze.

query

 Pobiera zawartość zadania raportu.