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 has-clause와 비슷하게 보고서 행을 집계한 후 적용됩니다. 이 필터에 측정기준을 사용할 수 없습니다.
offset

string (int64 format)

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

보고서 작업을 만들 때 offset 매개변수와 limit 매개변수는 생성된 보고서에 포함할 Google 애널리틱스 스토리지의 데이터 행의 하위 집합을 정의합니다. 예를 들어 Google 애널리틱스 스토리지에 총 300,000개의 행이 있는 경우 초기 보고서 작업에 한도가 10,000개이고 오프셋이 0인 처음 10,000개의 행이 포함될 수 있습니다. 이어서 다른 보고서 태스크에서 다음 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

선택사항입니다. ISO4217 형식의 통화 코드입니다(예: 'AED', 'USD', 'JPY'). 필드가 비어 있으면 보고서에서 속성의 기본 통화가 사용됩니다.
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(국가, ", ", 도시)입니다.

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(국가, ", ", 도시)입니다.

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 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 측정기준 값은 정렬 전에 숫자로 변환됩니다. 예를 들어 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이 1일이고 요청에 cohortNthDay가 포함된 경우 일반적으로 사용됩니다.
WEEKLY 주별 세부사항. 동질 집단의 dateRange가 1주일 기간 (일요일부터 토요일에 종료)이고 요청에 cohortNthWeek이 포함된 경우 일반적으로 사용됩니다.
MONTHLY 월별 세분화. 동질 집단의 dateRange가 한 달 동안 지속되고 요청에 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

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