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

Method: properties.runRealtimeReport

HTTP 요청
경로 매개변수
요청 본문
- JSON 표현
응답 본문
- JSON 표현
승인 범위
MinuteRange
- JSON 표현
사용해 보기

속성의 실시간 이벤트 데이터에 관한 맞춤 보고서를 반환합니다. 이벤트는 Google 애널리틱스로 전송된 몇 초 후에 실시간 보고서에 표시됩니다. 실시간 보고서에는 현재부터 30분 전 (Google 애널리틱스 360 속성의 경우 최대 60분)까지의 기간에 대한 이벤트 및 사용 데이터가 표시됩니다.

실시간 요청을 구성하고 응답을 이해하는 방법에 관한 가이드는 실시간 보고서 만들기를 참고하세요.

HTTP 요청

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport

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

경로 매개변수

매개변수

매개변수
`property`	`string` 이벤트가 추적되는 Google 애널리틱스 속성 식별자입니다. 본문이 아닌 URL 경로에 지정됩니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요. 예: properties/1234

property

string

이벤트가 추적되는 Google 애널리틱스 속성 식별자입니다. 본문이 아닌 URL 경로에 지정됩니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요.

예: properties/1234

요청 본문

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

JSON 표현

JSON 표현
{ "dimensions": [ { object (`Dimension`) } ], "metrics": [ { object (`Metric`) } ], "dimensionFilter": { object (`FilterExpression`) }, "metricFilter": { object (`FilterExpression`) }, "limit": string, "metricAggregations": [ enum (`MetricAggregation`) ], "orderBys": [ { object (`OrderBy`) } ], "returnPropertyQuota": boolean, "minuteRanges": [ { object (`MinuteRange`) } ] }

{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "returnPropertyQuota": boolean,
  "minuteRanges": [
    {
      object (MinuteRange)
    }
  ]
}

필드
`dimensions[]`	`object (Dimension)` 요청되고 표시된 측정기준입니다.
`metrics[]`	`object (Metric)` 요청되고 표시된 측정항목입니다.
`dimensionFilter`	`object (FilterExpression)` 측정기준의 필터 절입니다. 이 필터에서는 측정항목을 사용할 수 없습니다.
`metricFilter`	`object (FilterExpression)` 측정항목의 필터 절입니다. SQL having 절과 마찬가지로 집계 후 단계에서 적용됩니다. 이 필터에서는 측정기준을 사용할 수 없습니다.
`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)` 응답에서 행이 정렬되는 방식을 지정합니다.
`returnPropertyQuota`	`boolean` 이 Google 애널리틱스 속성의 실시간 할당량의 현재 상태를 반환할지 전환합니다. 할당량은 PropertyQuota에 반환됩니다.
`minuteRanges[]`	`object (MinuteRange)` 읽을 이벤트 데이터의 분 범위입니다. 지정하지 않으면 지난 30분 동안의 1분 범위가 사용됩니다. 분 범위가 여러 개 요청되면 각 응답 행에는 0부터 시작하는 분 범위 색인이 포함됩니다. 두 분 범위가 겹치면 겹치는 분의 이벤트 데이터가 두 분 범위의 응답 행에 포함됩니다.

응답 본문

요청에 해당하는 응답 실시간 보고서 테이블입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현

JSON 표현
{ "dimensionHeaders": [ { object (`DimensionHeader`) } ], "metricHeaders": [ { object (`MetricHeader`) } ], "rows": [ { object (`Row`) } ], "totals": [ { object (`Row`) } ], "maximums": [ { object (`Row`) } ], "minimums": [ { object (`Row`) } ], "rowCount": integer, "propertyQuota": { object (`PropertyQuota`) }, "kind": string }

{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "totals": [
    {
      object (Row)
    }
  ],
  "maximums": [
    {
      object (Row)
    }
  ],
  "minimums": [
    {
      object (Row)
    }
  ],
  "rowCount": integer,
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}

필드
`dimensionHeaders[]`	`object (DimensionHeader)` 측정기준 열을 설명합니다. DimensionHeader의 수와 DimensionHeader의 순서가 행에 있는 차원과 일치합니다.
`metricHeaders[]`	`object (MetricHeader)` 측정항목 열을 설명합니다. MetricHeader의 수와 MetricHeader의 순서가 행에 있는 측정항목과 일치합니다.
`rows[]`	`object (Row)` 보고서의 측정기준 값 조합 및 측정항목 값 행
`totals[]`	`object (Row)` 요청된 경우 측정항목의 합계 값입니다.
`maximums[]`	`object (Row)` 요청된 경우 측정항목의 최대 값입니다.
`minimums[]`	`object (Row)` 요청된 경우 측정항목의 최솟값입니다.
`rowCount`	`integer` 쿼리 결과의 총 행 수입니다. `rowCount`는 응답에 반환된 행 수 및 `limit` 요청 매개변수와 무관합니다. 예를 들어 쿼리가 175개의 행을 반환하고 API 요청에 50개의 `limit`가 포함된 경우 응답에는 175개의 `rowCount`가 포함되지만 50개의 행만 포함됩니다.
`propertyQuota`	`object (PropertyQuota)` 이 요청을 포함하여 이 Google 애널리틱스 속성의 실시간 할당량 상태입니다.
`kind`	`string` 이 메시지의 리소스 유형을 식별합니다. 이 `kind`는 항상 고정 문자열 'analyticsData#runRealtimeReport'입니다. JSON에서 응답 유형을 구분하는 데 유용합니다.

승인 범위

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

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

MinuteRange

연속된 분 집합: startMinutesAgo, startMinutesAgo + 1, ..., endMinutesAgo 요청은 최대 2분 범위까지 허용됩니다.

JSON 표현
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer }

필드

필드
`name`	`string` 이 분 범위에 이름을 할당합니다. 보고서 응답에서 측정기준 `dateRange`의 값은 이 이름으로 설정됩니다. 설정된 경우 `date_range_` 또는 `RESERVED_`로 시작할 수 없습니다. 설정하지 않으면 분 범위는 요청의 0 기반 색인(`date_range_0`, `date_range_1` 등)으로 이름이 지정됩니다.
`startMinutesAgo`	`integer` 쿼리의 시작 시간을 현재로부터 몇 분 전으로 나타냅니다. 예를 들어 `"startMinutesAgo": 29`는 보고서에 29분 전 이후의 이벤트 데이터가 포함되어야 한다고 지정합니다. `endMinutesAgo` 이후일 수 없습니다. 지정하지 않으면 `startMinutesAgo`의 기본값은 29입니다. 표준 애널리틱스 속성은 최대 최근 30분 동안의 이벤트 데이터 (`startMinutesAgo <= 29`)를 요청할 수 있으며, 360 애널리틱스 속성은 최대 최근 60분 동안의 이벤트 데이터 (`startMinutesAgo <= 59`)를 요청할 수 있습니다.
`endMinutesAgo`	`integer` 현재로부터 몇 분 전까지의 쿼리 종료 시간을 분으로 나타냅니다. `startMinutesAgo` 이전일 수 없습니다. 예를 들어 `"endMinutesAgo": 15`는 보고서에 15분 전 이전의 이벤트 데이터가 포함되어야 한다고 지정합니다. 지정하지 않으면 `endMinutesAgo`의 기본값은 0입니다. 표준 애널리틱스 속성은 지난 30분 동안의 이벤트 데이터 (`endMinutesAgo <= 29`)를 요청할 수 있으며, 360 애널리틱스 속성은 지난 60분 동안의 이벤트 데이터 (`endMinutesAgo <= 59`)를 요청할 수 있습니다.

name

string

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

startMinutesAgo

integer

쿼리의 시작 시간을 현재로부터 몇 분 전으로 나타냅니다. 예를 들어 "startMinutesAgo": 29는 보고서에 29분 전 이후의 이벤트 데이터가 포함되어야 한다고 지정합니다. endMinutesAgo 이후일 수 없습니다.

지정하지 않으면 startMinutesAgo의 기본값은 29입니다. 표준 애널리틱스 속성은 최대 최근 30분 동안의 이벤트 데이터 (startMinutesAgo <= 29)를 요청할 수 있으며, 360 애널리틱스 속성은 최대 최근 60분 동안의 이벤트 데이터 (startMinutesAgo <= 59)를 요청할 수 있습니다.

endMinutesAgo

integer

현재로부터 몇 분 전까지의 쿼리 종료 시간을 분으로 나타냅니다. startMinutesAgo 이전일 수 없습니다. 예를 들어 "endMinutesAgo": 15는 보고서에 15분 전 이전의 이벤트 데이터가 포함되어야 한다고 지정합니다.

지정하지 않으면 endMinutesAgo의 기본값은 0입니다. 표준 애널리틱스 속성은 지난 30분 동안의 이벤트 데이터 (endMinutesAgo <= 29)를 요청할 수 있으며, 360 애널리틱스 속성은 지난 60분 동안의 이벤트 데이터 (endMinutesAgo <= 59)를 요청할 수 있습니다.