Method: runReport

Google 애널리틱스 이벤트 데이터의 맞춤 보고서를 반환합니다. 보고서에는 Google 애널리틱스 추적 코드를 통해 수집된 데이터에서 파생된 통계가 포함됩니다. API에서 반환된 데이터는 요청된 측정기준 및 측정항목에 대한 열이 포함된 표로 표시됩니다. 측정항목은 활성 사용자, 이벤트 수 등 속성에서 사용자 활동을 개별적으로 측정한 것입니다. 측정기준은 국가 또는 이벤트 이름과 같은 몇 가지 일반적인 기준으로 측정항목을 세분화합니다.

HTTP 요청

POST https://analyticsdata.googleapis.com/v1alpha:runReport

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
필드
entity

object (Entity)

이벤트가 추적되는 속성입니다. 일괄 요청 내에서 이 항목은 지정되지 않거나 일괄 수준 항목과 일치해야 합니다.
dimensions[]

object (Dimension)

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

object (Metric)

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

object (DateRange)

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

string (int64 format)

시작 행의 행 수입니다. 첫 번째 행은 0행으로 계산됩니다.
limit

string (int64 format)

반환할 행의 개수입니다. limit 매개변수를 지정하지 않으면 행 10,000개가 반환됩니다. API는 요청 수에 관계없이 요청당 최대 100,000개의 행을 반환합니다.
metricAggregations[]

enum (MetricAggregation)

측정항목 집계 집계된 측정항목 값은 dimensionValues가 'RESERVED_(MetricAggregation)'으로 설정된 행에 표시됩니다.
dimensionFilter

object (FilterExpression)

측정기준의 필터 절입니다. 이 필터에 사용하려면 측정기준을 요청해야 합니다. 이 필터에서는 측정항목을 사용할 수 없습니다.
metricFilter

object (FilterExpression)

측정항목의 필터 절입니다. SQL의 조건과 마찬가지로 집계 후 단계에서 적용됩니다. 이 필터에서 사용하려면 측정항목을 요청해야 합니다. 이 필터에서는 측정기준을 사용할 수 없습니다.
orderBys[]

object (OrderBy)

응답에서 행이 정렬되는 방식을 지정합니다.
currencyCode

string

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

object (CohortSpec)

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

boolean

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

boolean

이 애널리틱스 속성의 할당량의 현재 상태를 반환할지 여부를 전환합니다. 할당량은 PropertyQuota에 반환됩니다.

응답 본문

성공한 경우 응답 본문에 RunReportResponse의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics