REST Resource: properties.reportTasks

Zasób: ReportTask

Konkretna 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 wysłane żądanie dotyczące wielu 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 o zdarzeniach z nakładających się dni są uwzględniane w wierszach odpowiedzi dla obu zakresów dat. W przypadku żądania dotyczącego kohorty 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-u. 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 000 wierszy z limitem 10 000 i przesunięciem 10 000.
limit

string (int64 format)

Opcjonalnie. Liczba wierszy do zwrócenia w raporcie. Jeśli nie określono inaczej, zwracanych jest 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 liczba wartości wymiarów jest mniejsza niż 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ść limit na wyższą.country
metricAggregations[]

enum (MetricAggregation)

Opcjonalnie. Agregacja danych. Zagregowane wartości danych 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. „AED”, „USD”, „JPY”. Jeśli 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 mają wartość 0, nie zostanie zwrócony. Jeśli ma wartość Prawda, te wiersze zostaną zwrócone, o ile nie zostaną osobno usunięte przez filtr.

Niezależnie od tego ustawienia keepEmptyRows w raporcie można wyświetlać 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 raportu 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 podasz dimensionExpression, name może być dowolnym ciągiem znaków z dozwolonego zestawu. Jeśli np. wymiar dimensionExpression łączy wymiary country i city, możesz go nazwać 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 jeden typ wyrażenia wymiaru dla DimensionExpression. Poniżej znajduje się lista pól, które wykluczają się nawzajem. 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 ogranicznik, w odpowiedzi będą widoczne oba znaki 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

Informacje wyrażone w formie liczbowej 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 sekcji Dane w czasie rzeczywistym. Listę nazw danych obsługiwanych przez metodę runFunnelReport znajdziesz w artykule Dane dotyczące ścieżki.

Jeśli podasz 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_]$.

Wskaźniki są podawane w name w metricFilter, orderBys i expression.
expression

string

Wyrażenie matematyczne dla danych obliczonych. 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 metricFilter, orderBys lub w danych expression.

Zakres dat

Ciągły zestaw dni: startDate, startDate + 1, ..., endDate. Możesz przesłać 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 dacie 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 być wcześniejsza niż 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 klucza date_range_ ani RESERVED_. Jeśli nie jest ustawiony, zakresy dat są nazywane na podstawie indeksu w żądaniu (liczonego od zera): date_range_0, date_range_1 itd.

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 jeden typ wyrażenia filtra dla FilterExpression. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
andGroup

object (FilterExpressionList)

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

object (FilterExpressionList)

Elementy FilterExpression w orGroup są ze sobą powiązane operatorem OR.
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ć albo wymiarami, albo rodzajami danych.
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 służące 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 nazwa 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 wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
stringFilter

object (StringFilter)

Filtr powią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, takich jak „(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 ma wartość 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.
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 Dopasowanie częściowe wyrażenia regularnego do wartości ciągu tekstowego.

InListFilter

Wynik musi być listą wartości w formie ciągów 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 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 przy tym filtrze.
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 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
Jedna z wartości liczbowych. 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 wskazać, ż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ę tą liczbą;

EmptyFilter

Ten typ nie ma pól.

Filtruj według pustych wartości.

MetricAggregation

Reprezentuje agregację danych.

Wartości w polu enum
METRIC_AGGREGATION_UNSPECIFIED Nieokreślony operator.
TOTAL Operator SUMA.
MINIMUM Operator minimum.
MAXIMUM Maksymalny operator.
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 tekstowego 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 kolejności sortowania dla OrderBy. Poniżej znajduje się lista pól, które wykluczają się nawzajem. 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 wymiaru.

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ć uporzą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 Alfanumeryczne sortowanie 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 wymiarów nienumerycznych mają taką samą wartość porządkowania, która jest niższa niż wszystkie wartości numeryczne.

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 kohorcie z pierwszego tygodnia 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ć tygodniowy szereg czasowy, w którym np. po 3 tygodniach aplikacja utrzymała 60% tej kohorty, a po 6 tygodniach – 25%. Te 2 wartości procentowe można obliczyć za pomocą rodzaju danych cohortActiveUsers/cohortTotalUsers. Będą one wyświetlane w raporcie w osobnych 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 kohort definiuje tylko jedną kohortę. Jeśli określono wiele kohort, każdą z nich można rozpoznać w raporcie po nazwie.
cohortsRange

object (CohortsRange)

Raporty kohortowe ś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, którzy mają wspólną cechę. Na przykład użytkownicy z tą samą 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 klucza 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ę. Wymagane i obsługuje tylko wartość firstSessionDate.
dateRange

object (DateRange)

Kohorta wybiera użytkowników, których data pierwszego kontaktu mieści się w zakresie dat określonym w dateRange. Ten parametr 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 zdarzeń dla 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 polu RunReportRequest lub RunPivotReportRequest musi być nieokreślony.

Ten dateRange powinien być zwykle zgodny z poziomem 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 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że być dopasowany do miesiąca, zaczynając się pierwszego i kończąc ostatniego dnia 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. startOffset jest zwykle ustawiona 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 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

Ustawienia opcjonalne raportu dotyczącego kohorty.

Zapis JSON 
{
  "accumulate": boolean
}
Pola
accumulate

boolean

Jeśli wartość to „true”, wynik jest kumulowany od dnia pierwszego kontaktu do dnia zakończenia. Nieobsługiwane na ścieżce 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 związanego z raportem.

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 funkcję 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 wynikach raportu. To pole zostanie wypełnione, gdy stan będzie aktywny. W ramach istniejącego raportu możesz używać taskRowCount do podziału na strony.
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 obejmuje łączną liczbę wierszy we wszystkich danych pobranych z pamięci Google Analytics.

Załóżmy na przykład, że bieżąca wartość taskRowCount w raporcie to 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 podzielić na strony pierwsze 20 wierszy. 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 dotyczących usługi.

query

 Pobiera zawartość zadania raportu.