REST Resource: properties.reportTasks

리소스: ReportTask

특정 보고서 작업 구성

JSON 표현 
{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}
필드
name

string

출력 전용입니다. 식별자. 생성 중에 할당된 보고서 작업 리소스 이름입니다. 형식: 'properties/{property}/reportTasks/{reportTask}'
reportDefinition

object (ReportDefinition)

선택사항입니다. 보고서 데이터를 가져오기 위한 보고서 정의로, 보고서의 구조를 설명합니다. 일반적으로 보고서에 포함될 필드와 데이터를 필터링하는 데 사용되는 기준이 포함됩니다.
reportMetadata

object (ReportMetadata)

출력 전용입니다. 특정 보고서 작업에 대한 보고서 메타데이터로, 보고서에 대한 정보를 제공합니다. 일반적으로 보고서의 리소스 이름, 보고서 상태, 보고서 생성 타임스탬프 등의 정보가 포함됩니다.

ReportDefinition

보고서 실행 방법에 대한 정의입니다.

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

object (Dimension)

선택사항입니다. 요청 및 표시된 측정기준입니다.
metrics[]

object (Metric)

선택사항입니다. 요청 및 표시된 측정항목입니다.
dateRanges[]

object (DateRange)

선택사항입니다. 읽을 데이터의 기간입니다. 여러 기간이 요청되면 각 응답 행에 0을 기반으로 하는 기간 색인이 포함됩니다. 두 기간이 겹치는 경우, 겹치는 날짜의 이벤트 데이터가 두 기간의 응답 행에 포함됩니다. 동질 집단 요청에서 이 dateRanges는 지정하지 않아야 합니다.
dimensionFilter

object (FilterExpression)

선택사항입니다. 측정기준 필터를 사용하면 보고서에서 특정 측정기준 값만 요청할 수 있습니다. 자세한 내용은 측정기준 필터의 기본사항에 나온 예를 참고하세요. 이 필터에서는 측정항목을 사용할 수 없습니다.
metricFilter

object (FilterExpression)

선택사항입니다. 측정항목의 필터 절입니다. SQL의 have-clause와 마찬가지로 보고서의 행을 집계한 후에 적용됩니다. 이 필터에서는 측정기준을 사용할 수 없습니다.
offset

string (int64 format)

선택사항입니다. Google 애널리틱스 스토리지에서 시작 행의 행 수입니다. 첫 번째 행은 0행으로 계산됩니다.

보고서 작업을 만들 때 offset 및 limit 매개변수는 생성된 보고서에 포함할 Google 애널리틱스 스토리지의 데이터 행의 하위 집합을 정의합니다. 예를 들어 Google 애널리틱스 스토리지에 총 300,000개의 행이 있는 경우 초기 보고서 작업에는 처음 10,000개의 행이 포함될 수 있으며 한도는 10,000개이고 오프셋은 0입니다. 이후에는 다른 보고서 작업에서 10,000개의 한도와 10,000개의 오프셋을 지정하여 다음 10,000개의 행을 처리할 수 있습니다.
limit

string (int64 format)

선택사항입니다. 보고서에서 반환할 행의 개수입니다. 지정하지 않으면 10,000행이 반환됩니다. API는 요청 수에 관계없이 요청당 최대 250,000개의 행을 반환합니다. limit 값은 양수여야 합니다.

측정기준 값이 limit만큼 많지 않은 경우 API는 요청된 limit보다 적은 수의 행을 반환할 수도 있습니다. 예를 들어 country 측정기준에 사용할 수 있는 값이 300개 미만이므로 country만 보고하는 경우 limit를 더 높은 값으로 설정하더라도 300개를 초과하는 행을 가져올 수 없습니다.
metricAggregations[]

enum (MetricAggregation)

선택사항입니다. 측정항목 집계 집계된 측정항목 값은 dimensionValues가 'RESERVED_(MetricAggregation)'으로 설정된 행에 표시됩니다.
orderBys[]

object (OrderBy)

선택사항입니다. 응답에서 행이 정렬되는 방식을 지정합니다.
currencyCode

string

선택사항입니다. 'AED', 'USD', 'JPY'와 같은 ISO4217 형식의 통화 코드입니다. 필드가 비어 있으면 보고서에서는 속성의 기본 통화를 사용합니다.
cohortSpec

object (CohortSpec)

선택사항입니다. 이 요청과 연결된 동질 집단 그룹입니다. 요청에 동질 집단 그룹이 있는 경우 '동질 집단' 차원이 있어야 합니다.
keepEmptyRows

boolean

선택사항입니다. false이거나 지정되지 않은 경우 모든 측정항목이 0인 각 행이 반환되지 않습니다. true인 경우 필터에 의해 별도로 삭제되지 않는 경우 이러한 행이 반환됩니다.

이 keepEmptyRows 설정과 관계없이 Google 애널리틱스 (GA4) 속성에서 기록한 데이터만 보고서에 표시될 수 있습니다.

예를 들어 속성이 purchase 이벤트를 로깅하지 않는 경우 eventName 측정기준 및 eventCount 측정항목에 대한 쿼리에는 eventName: 'purchase'가 포함된 행이 없습니다. eventCount: 0입니다.

측정기준

측정기준은 데이터의 속성입니다. 예를 들어 도시 측정기준은 이벤트가 발생한 도시를 나타냅니다. 보고서 응답의 측정기준 값은 문자열입니다. 예를 들어 도시는 '파리'일 수 있습니다. 또는 '뉴욕'을 입력합니다.

JSON 표현 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
필드
name

string

측정기준의 이름입니다. runReport 및 batchRunReports과 같은 핵심 보고 메서드에서 지원되는 측정기준 이름 목록은 API 측정기준을 참고하세요. runRealtimeReport 메서드에서 지원되는 측정기준 이름 목록은 실시간 측정기준을 참조하세요. runFunnelReport 메서드에서 지원되는 측정기준 이름 목록은 유입경로 측정기준을 참고하세요.

dimensionExpression가 지정된 경우 name는 허용된 문자 집합 내에서 원하는 문자열이 될 수 있습니다. 예를 들어 dimensionExpression가 country와 city를 연결하는 경우 이 측정기준을 countryAndCity로 호출할 수 있습니다. 선택한 측정기준 이름은 정규 표현식 ^[a-zA-Z0-9_]$과(와) 일치해야 합니다.

측정기준은 dimensionFilter, orderBys, dimensionExpression, pivots의 name에서 참조합니다.
dimensionExpression

object (DimensionExpression)

한 측정기준은 여러 측정기준의 표현식의 결과일 수 있습니다. 예를 들어 '국가, 도시' 측정기준: concatenate(country, ", ", City)를 사용합니다.

DimensionExpression

여러 측정기준의 수식의 결과인 측정기준을 표현하는 데 사용됩니다. 사용 예: 1) lowerCase(dimension) 2) concatenate(dimension1, sym, dimension2)입니다.

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.
}
필드
통합 필드 one_expression. DimensionExpression에 대한 측정기준 표현식의 한 유형을 지정하세요. one_expression은 다음 중 하나일 수 있습니다.
lowerCase

object (CaseExpression)

크기 값을 소문자로 변환하는 데 사용됩니다.
upperCase

object (CaseExpression)

측정기준 값을 대문자로 변환하는 데 사용됩니다.
concatenate

object (ConcatenateExpression)

측정기준 값을 단일 측정기준에 결합하는 데 사용됩니다. 예를 들어 '국가, 도시' 측정기준: concatenate(country, ", ", City)를 사용합니다.

CaseExpression

측정기준 값을 단일 케이스로 변환하는 데 사용됩니다.

JSON 표현 
{
  "dimensionName": string
}
필드
dimensionName

string

측정기준의 이름입니다. 이름은 요청의 측정기준 필드에 있는 이름을 다시 참조해야 합니다.

ConcatenateExpression

측정기준 값을 단일 측정기준에 결합하는 데 사용됩니다.

JSON 표현 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
필드
dimensionNames[]

string

측정기준의 이름입니다. 이름은 요청의 측정기준 필드에 있는 이름을 다시 참조해야 합니다.
delimiter

string

측정기준 이름 사이에 배치되는 구분자입니다.

구분 기호는 '|'와 같은 단일 문자인 경우가 많습니다. 또는 "," 더 긴 문자열이 될 수 있습니다. 측정기준 값에 구분자가 포함되어 있으면 둘 다 구분 없이 응답으로 표시됩니다. 예를 들어 측정기준 1의 값이 'US,FR', 측정기준 2의 값이 'JP', 구분자 = ','인 경우 응답에 'US,FR,JP'가 포함됩니다.

측정항목

보고서의 정량적 측정값입니다. 예를 들어 eventCount 측정항목은 총 이벤트 수입니다. 요청은 최대 10개의 측정항목까지 허용됩니다.

JSON 표현 
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
필드
name

string

측정항목의 이름입니다. runReport 및 batchRunReports과 같은 핵심 보고 메서드에서 지원되는 측정항목 이름 목록은 API 측정항목을 참고하세요. runRealtimeReport 메서드에서 지원되는 측정항목 이름 목록은 실시간 측정항목을 참조하세요. runFunnelReport 메서드에서 지원되는 측정항목 이름 목록은 유입경로 측정항목을 참조하세요.

expression가 지정된 경우 name는 허용된 문자 집합 내에서 원하는 문자열이 될 수 있습니다. 예를 들어 expression이 screenPageViews/sessions이면 측정항목의 이름을 viewsPerSession로 지정할 수 있습니다. 선택한 측정항목 이름은 정규 표현식 ^[a-zA-Z0-9_]$과 일치해야 합니다.

측정항목은 metricFilter, orderBys, 측정항목 expression의 name에서 참조합니다.
expression

string

파생된 측정항목의 수학 표현식입니다. 예를 들어 사용자당 이벤트 수는 eventCount/totalUsers입니다.
invisible

boolean

보고서 응답에 측정항목이 표시되지 않는지 여부를 나타냅니다. 측정항목이 표시되지 않으면 측정항목은 응답에 열을 생성하지 않지만 metricFilter, orderBys 또는 측정항목 expression에서는 사용할 수 있습니다.

DateRange

연속된 일수: startDate, startDate + 1, ..., endDate. 요청은 최대 4개의 기간까지 허용됩니다.

JSON 표현 
{
  "startDate": string,
  "endDate": string,
  "name": string
}
필드
startDate

string

YYYY-MM-DD 형식으로 된 쿼리의 시작 날짜입니다. endDate 이후일 수 없습니다. NdaysAgo, yesterday 또는 today 형식도 허용되며, 이 경우 날짜는 속성의 보고 시간대를 기반으로 추론됩니다.
endDate

string

YYYY-MM-DD 형식으로 된 쿼리의 종료 날짜입니다. startDate 이전일 수 없습니다. NdaysAgo, yesterday 또는 today 형식도 허용되며, 이 경우 날짜는 속성의 보고 시간대를 기반으로 추론됩니다.
name

string

이 기간에 이름을 지정합니다. 보고서 응답에서 측정기준 dateRange의 값은 이 이름으로 지정됩니다. 설정된 경우 date_range_ 또는 RESERVED_로 시작할 수 없습니다. 설정하지 않으면 요청의 이름이 0부터 시작하는 색인(예: date_range_0, date_range_1)으로 지정됩니다.

FilterExpression

측정기준 또는 측정항목 필터를 표현하기 위해 동일한 FilterExpression의 필드는 모든 측정기준 또는 모든 측정항목이어야 합니다.

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.
}
필드
통합 필드 expr. FilterExpression에 대한 한 가지 필터 표현식 유형을 지정합니다. expr은 다음 중 하나일 수 있습니다.
andGroup

object (FilterExpressionList)

andGroup의 FilterExpressions는 AND 관계가 있습니다.
orGroup

object (FilterExpressionList)

orGroup의 FilterExpressions는 OR 관계가 있습니다.
notExpression

object (FilterExpression)

FilterExpression이 notExpression이 아닙니다.
filter

object (Filter)

기본 필터입니다. 동일한 FilterExpression에서 필터의 모든 필드 이름은 모든 측정기준 또는 모든 측정항목이어야 합니다.

FilterExpressionList

필터 표현식의 목록입니다.

JSON 표현 
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
필드
expressions[]

object (FilterExpression)

필터 표현식의 목록입니다.

필터

측정기준 또는 측정항목 값을 필터링하기 위한 표현식입니다.

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)
  }
  // End of list of possible types for union field one_filter.
}
필드
fieldName

string

측정기준 이름 또는 측정항목 이름입니다. 측정기준 또는 측정항목에 정의된 이름이어야 합니다.
통합 필드 one_filter. Filter의 한 가지 필터 유형을 지정합니다. one_filter은 다음 중 하나일 수 있습니다.
stringFilter

object (StringFilter)

문자열 관련 필터입니다.
inListFilter

object (InListFilter)

목록 값의 필터입니다.
numericFilter

object (NumericFilter)

숫자 또는 날짜 값에 대한 필터입니다.
betweenFilter

object (BetweenFilter)

두 값 사이의 필터입니다.

StringFilter

문자열 필터

JSON 표현 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
필드
matchType

enum (MatchType)

이 필터의 일치 유형입니다.
value

string

일치에 사용되는 문자열 값입니다.
caseSensitive

boolean

true인 경우 문자열 값은 대소문자를 구분합니다.

MatchType

문자열 필터의 일치 유형

열거형
MATCH_TYPE_UNSPECIFIED 미지정
EXACT 문자열 값과 정확하게 일치하는 값입니다.
BEGINS_WITH 문자열 값으로 시작합니다.
ENDS_WITH 문자열 값으로 끝납니다.
CONTAINS 문자열 값을 포함합니다.
FULL_REGEXP 문자열 값이 있는 정규 표현식과 완전히 일치합니다.
PARTIAL_REGEXP 문자열 값이 있는 정규 표현식의 부분 일치입니다.

InListFilter

결과는 문자열 값 목록에 있어야 합니다.

JSON 표현 
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
필드
values[]

string

문자열 값의 목록입니다. 비어 있지 않아야 합니다.
caseSensitive

boolean

true인 경우 문자열 값은 대소문자를 구분합니다.

NumericFilter

숫자 또는 날짜 값에 대한 필터입니다.

JSON 표현 
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
필드
operation

enum (Operation)

이 필터의 연산 유형입니다.
value

object (NumericValue)

숫자 값 또는 날짜 값입니다.

작업

숫자 필터에 적용된 연산입니다.

열거형
OPERATION_UNSPECIFIED 지정되지 않았습니다.
EQUAL 같음
LESS_THAN 미만
LESS_THAN_OR_EQUAL 작거나 같음
GREATER_THAN 초과
GREATER_THAN_OR_EQUAL 이상

NumericValue

숫자를 나타냅니다.

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.
}
필드
통합 필드 one_value. 숫자 값 one_value 중 하나는 다음 중 하나여야 합니다.
int64Value

string (int64 format)

정수 값
doubleValue

number

이중 값

BetweenFilter

결과가 두 숫자 (두 숫자 포함) 사이에 있어야 함을 표현합니다.

JSON 표현 
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
필드
fromValue

object (NumericValue)

이 숫자로 시작합니다.
toValue

object (NumericValue)

이 번호로 끝납니다.

MetricAggregation

측정항목 집계를 나타냅니다.

열거형
METRIC_AGGREGATION_UNSPECIFIED 연산자가 지정되지 않았습니다.
TOTAL SUM 연산자.
MINIMUM 최소 연산자입니다.
MAXIMUM 최대 연산자입니다.
COUNT 개수 연산자.

OrderBy

정렬 기준은 응답에서 행이 정렬되는 방식을 정의합니다. 예를 들어 이벤트 수의 내림차순으로 행을 정렬하는 것은 하나의 순서이며, 이벤트 이름 문자열을 기준으로 행을 정렬하는 것은 다른 순서입니다.

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.
}
필드
desc

boolean

true인 경우 내림차순으로 정렬합니다.
통합 필드 one_order_by. OrderBy에 한 가지 정렬 기준 유형을 지정합니다. one_order_by은 다음 중 하나일 수 있습니다.
metric

object (MetricOrderBy)

측정항목 값을 기준으로 결과를 정렬합니다.
dimension

object (DimensionOrderBy)

측정기준의 값을 기준으로 결과를 정렬합니다.

MetricOrderBy

측정항목 값을 기준으로 정렬합니다.

JSON 표현 
{
  "metricName": string
}
필드
metricName

string

정렬 기준 요청의 측정항목 이름입니다.

DimensionOrderBy

측정기준 값을 기준으로 정렬합니다.

JSON 표현 
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
필드
dimensionName

string

정렬 기준 요청의 측정기준 이름입니다.
orderType

enum (OrderType)

측정기준 값 정렬 규칙을 제어합니다.

OrderType

문자열 측정기준 값의 순서를 지정하는 규칙입니다.

열거형
ORDER_TYPE_UNSPECIFIED 지정되지 않았습니다.
ALPHANUMERIC 유니코드 코드 포인트별로 영숫자로 정렬합니다. 예: '2' < 'A' < 'X' < 'b' < 'z'
CASE_INSENSITIVE_ALPHANUMERIC 대소문자를 구분하지 않는 영숫자로 된 소문자 유니코드 코드 포인트로 정렬합니다. 예: '2' < 'A' < 'b' < 'X' < 'z'
NUMERIC 측정기준 값은 정렬 전에 숫자로 변환됩니다. 예를 들어, 숫자 정렬에서는 '25'입니다. < '100' 및 ALPHANUMERIC 정렬에서 '100' < '25'. 숫자가 아닌 측정기준 값은 모두 모든 숫자 값보다 낮은 순서 값을 갖습니다.

CohortSpec

동질 집단 보고서의 동질 집단 사양입니다.

동질 집단 보고서는 동질 집단의 사용자 유지율에 대한 시계열을 만듭니다. 예를 들어 9월 첫째 주에 획득한 사용자 집단을 선택하고 이후 6주 동안 해당 동질 집단을 팔로우할 수 있습니다. 9월 동질 집단의 첫째 주에 획득한 사용자를 선택하는 방법은 cohort 객체에서 지정합니다. 이 사용자 집단 다음에 이후 6주 동안은 cohortsRange 객체에 지정됩니다.

예를 보려면 동질 집단 보고서 예를 참고하세요.

보고서 응답에는 앱이 3주 후에 동질 집단의 60% 를 유지하고 6주 후에 이 동질 집단의 25% 를 유지한다고 말하는 주별 시계열이 표시될 수 있습니다. 이 두 비율은 cohortActiveUsers/cohortTotalUsers 측정항목으로 계산될 수 있으며 보고서에서 별도의 행으로 표시됩니다.

JSON 표현 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
필드
cohorts[]

object (Cohort)

사용자를 동질 집단으로 그룹화하기 위한 선택 기준을 정의합니다.

대부분의 동질 집단 보고서에서는 하나의 동질 집단만 정의합니다. 여러 동질 집단이 지정된 경우 각 동질 집단은 보고서에서 이름으로 인식될 수 있습니다.
cohortsRange

object (CohortsRange)

동질 집단 보고서는 확장된 보고 기간에 걸쳐 동질 집단을 추적합니다. 이 범위는 동질 집단을 따라가는 오프셋 기간을 지정합니다.
cohortReportSettings

object (CohortReportSettings)

동질 집단 보고서의 설정(선택사항)입니다.

코호트

동질 집단 선택 기준을 정의합니다. 동질 집단은 공통된 특징을 가진 사용자 그룹입니다. 예를 들어 firstSessionDate가 동일한 사용자는 동일한 동질 집단에 속합니다.

JSON 표현 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
필드
name

string

이 동질 집단에 이름을 할당합니다. 보고서 응답에서 측정기준 cohort의 값은 이 이름으로 지정됩니다. 설정된 경우 cohort_ 또는 RESERVED_로 시작할 수 없습니다. 설정하지 않으면 동질 집단의 이름이 0부터 시작하는 색인 cohort_0, cohort_1 등으로 지정됩니다.
dimension

string

동질 집단에서 사용하는 측정기준입니다. 필수이며 firstSessionDate만 지원합니다.
dateRange

object (DateRange)

동질 집단에서 첫 번째 터치 날짜가 dateRange에 정의된 시작일과 종료일 사이에 있는 사용자를 선택합니다. 이 dateRange은 동질 집단 보고서에 표시되는 이벤트 데이터의 전체 기간을 지정하지 않습니다. 동질 집단 보고서에서 이 dateRange는 cohortsRange에 있는 세부사항과 오프셋에 의해 확장됩니다. 확장된 보고 기간에 대한 이벤트 데이터가 동질 집단 보고서에 표시됩니다.

동질 집단 요청에서 이 dateRange는 필수이며 RunReportRequest 또는 RunPivotReportRequest의 dateRanges는 지정하지 않아야 합니다.

이 dateRange는 일반적으로 동질 집단의 세부사항과 일치해야 합니다. CohortsRange에서 일별 세부사항을 사용하는 경우 이 dateRange는 하루가 될 수 있습니다. CohortsRange에서 주별 세부사항을 사용하는 경우 이 dateRange는 일요일부터 토요일까지 주 경계로 정렬될 수 있습니다. CohortsRange에서 월별 단위를 사용하는 경우 이 dateRange는 해당 월의 첫 번째 날부터 마지막 날까지 월 단위로 정렬할 수 있습니다.

CohortsRange

동질 집단 보고서의 확장된 보고 기간을 구성합니다. 동질 집단을 따르는 오프셋 기간을 지정합니다.

JSON 표현 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
필드
granularity

enum (Granularity)

필수 항목입니다. 동질 집단 보고서의 확장된 보고 기간에 대한 startOffset 및 endOffset을 해석하는 데 사용되는 세부정보입니다.
startOffset

integer

startOffset은 동질 집단 보고서의 확장된 보고 기간의 시작일을 지정합니다. startOffset는 일반적으로 0으로 설정되므로 보고서에 동질 집단 획득 이후의 데이터가 포함됩니다.

granularity이(가) DAILY인 경우, 확장된 보고 기간의 startDate은 동질 집단의 startDate에 startOffset일을 더한 값입니다.

granularity이(가) WEEKLY인 경우, 확장된 보고 기간의 startDate은 동질 집단의 startDate에 startOffset * 7일을 더한 값입니다.

granularity이(가) MONTHLY인 경우, 확장된 보고 기간의 startDate은 동질 집단의 startDate에 startOffset * 30일을 더한 값입니다.
endOffset

integer

필수 항목입니다. endOffset은 동질 집단 보고서의 연장된 보고 기간의 종료일을 지정합니다. endOffset는 양의 정수일 수 있지만 일반적으로는 5~10으로 설정되므로 보고서에 다음 세밀한 기간에 대한 동질 집단 데이터가 포함됩니다.

granularity이(가) DAILY인 경우, 확장된 보고 기간의 endDate은 동질 집단의 endDate에 endOffset일을 더한 값입니다.

granularity이(가) WEEKLY인 경우, 확장된 보고 기간의 endDate은 동질 집단의 endDate에 endOffset * 7일을 더한 값입니다.

granularity이(가) MONTHLY인 경우, 확장된 보고 기간의 endDate은 동질 집단의 endDate에 endOffset * 30일을 더한 값입니다.

세부사항

동질 집단 보고서의 확장된 보고 기간에 대한 startOffset 및 endOffset을 해석하는 데 사용되는 세부정보입니다.

열거형
GRANULARITY_UNSPECIFIED 지정해서는 안 됩니다.
DAILY 일별 세분화. 동질 집단의 dateRange가 하루이고 요청에 cohortNthDay이 포함된 경우 일반적으로 사용됩니다.
WEEKLY 주별 세부정보 동질 집단의 dateRange가 1주일 (일요일부터 토요일까지)이고 요청에 cohortNthWeek이 포함된 경우 일반적으로 사용됩니다.
MONTHLY 월별 세부사항: 동질 집단의 dateRange가 1개월이고 요청에 cohortNthMonth이 포함된 경우 일반적으로 사용됩니다.

CohortReportSettings

동질 집단 보고서의 설정(선택사항)입니다.

JSON 표현 
{
  "accumulate": boolean
}
필드
accumulate

boolean

true인 경우 첫 번째 터치일부터 종료일까지 결과를 누적합니다. RunReportRequest에서는 지원되지 않습니다.

ReportMetadata

특정 보고서 작업에 대한 보고서 메타데이터입니다.

JSON 표현 
{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}
필드
creationQuotaTokensCharged

integer

출력 전용입니다. 보고서 생성 중에 청구된 총 할당량 토큰입니다. 이 토큰 수는 CREATING 상태의 활동을 기반으로 하므로 보고서 작업이 ACTIVE 또는 FAILED 상태가 되면 토큰 요금이 수정됩니다.
state

enum (State)

출력 전용입니다. 이 보고서 작업의 현재 상태입니다.
beginCreatingTime

string (Timestamp format)

출력 전용입니다. reportTasks.create가 호출되고 보고서가 CREATING 상태를 시작한 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
taskRowCount

integer

출력 전용입니다. 보고서 결과의 총 행 수입니다. 이 필드는 상태가 활성화되면 채워집니다. 기존 보고서 범위 내에서 페이지로 나누기에 taskRowCount를 활용할 수 있습니다.
errorMessage

string

출력 전용입니다. 생성 중에 보고서 태스크가 실패하면 오류 메시지가 채워집니다.
totalRowCount

integer

출력 전용입니다. Google 애널리틱스 스토리지의 총 행 수입니다. 현재 보고서 이외의 추가 데이터 행을 쿼리하려는 경우 totalRowCount를 기반으로 새 보고서 작업을 시작할 수 있습니다.

taskRowCount는 현재 보고서에 해당하는 행의 수를 나타내고, totalRowCount는 Google 애널리틱스 스토리지에서 가져온 모든 데이터의 총 행 수를 나타냅니다.

예를 들어 현재 보고서의 taskRowCount이 20이고 처음 20개 행의 데이터를 표시한다고 가정해 보겠습니다. 동시에 totalRowCount는 30이며, 이는 30개 행 모두의 데이터가 있음을 나타냅니다. taskRowCount를 활용하여 처음 20개 행을 페이지로 나눌 수 있습니다. 보고서를 확장하고 30개 행 모두의 데이터를 포함하려면 totalRowCount를 사용하여 새 보고서 작업을 만들어 30개 행의 전체 세트에 액세스할 수 있습니다. 가치 있는 정보를 얻을 수 있습니다.

주

처리 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태는 사용되지 않습니다.
CREATING 이 보고서는 현재 생성 중이며 나중에 사용할 수 있습니다. CreateReport 호출 직후에 생성이 발생합니다.
ACTIVE 보고서가 완전히 생성되어 쿼리할 준비가 되었습니다.
FAILED 보고서를 만들 수 없습니다.

메서드

create

 보고서 태스크 생성을 시작합니다.

get

 특정 보고서 작업에 대한 보고서 메타데이터를 가져옵니다.

list

 속성의 모든 보고서 작업을 나열합니다.

query

 보고서 작업의 콘텐츠를 검색합니다.