이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Method: runReport

HTTP 요청
요청 본문
- JSON 표현
응답 본문
승인 범위
실습

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

HTTP 요청

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

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

요청 본문

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

JSON 표현

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