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,
  "samplingLevel": enum (SamplingLevel)
}
필드
dimensions[]

object (Dimension)

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

object (Metric)

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

object (DateRange)

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

object (FilterExpression)

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

object (FilterExpression)

선택사항입니다. 측정항목의 필터 절입니다. SQL having 절과 유사하게 보고서 행을 집계한 후에 적용됩니다. 이 필터에는 측정기준을 사용할 수 없습니다.
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 애널리틱스 속성에서 기록한 데이터만 보고서에 표시할 수 있습니다.

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

enum (SamplingLevel)

선택사항입니다. 보고서의 샘플링 수준입니다.

측정기준

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

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, symbol, 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)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // 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)

두 값 사이의 필터입니다.
emptyFilter

object (EmptyFilter)

'(not set)', '' 값과 같은 빈 값의 필터입니다.

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)

이 숫자로 끝납니다.

EmptyFilter

이 유형에는 필드가 없습니다.

빈 값에 대해 필터링합니다.

MetricAggregation

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

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

OrderBy

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

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에서는 지원되지 않습니다.

SamplingLevel

요청의 샘플링 수준 카테고리입니다.

열거형
SAMPLING_LEVEL_UNSPECIFIED 알 수 없는 유형.
LOW 표준 속성에는 1,000만, Google 애널리틱스 360 속성에는 1억의 샘플링 수준이 적용됩니다.
MEDIUM 샘플링 수준이 10억인 Google 애널리틱스 360 속성에서만 사용할 수 있습니다.
UNSAMPLED Google 애널리틱스 360 속성 전용입니다. 전체 데이터 탐색 분석은 정확도가 높으며 표준 탐색 분석에서는 보이지 않던 유용한 정보를 표시할 수 있습니다. 자세한 내용은 https://support.google.com/analytics/answer/10896953을 참고하세요.

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 상태를 시작한 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
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

 보고서 작업의 콘텐츠를 가져옵니다.