Google 애널리틱스 이벤트 데이터의 맞춤 보고서를 반환합니다. 보고서에는 Google 애널리틱스 추적 코드를 통해 수집된 데이터에서 파생된 통계가 포함됩니다. API에서 반환된 데이터는 요청된 측정기준 및 측정항목에 대한 열이 포함된 표로 표시됩니다. 측정항목은 활성 사용자, 이벤트 수 등 속성에서 사용자 활동을 개별적으로 측정한 것입니다. 측정기준은 국가 또는 이벤트 이름과 같은 몇 가지 일반적인 기준으로 측정항목을 세분화합니다.
요청 구성 및 자세한 내용은 보고서 만들기를 참조하세요.
HTTP 요청
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runReport
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
property |
이벤트가 추적되는 Google 애널리틱스 GA4 속성 식별자입니다. 본문이 아닌 URL 경로에 지정됩니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요. 일괄 요청 내에서 이 속성은 지정되지 않거나 일괄 수준 속성과 일치해야 합니다. 예: properties/1234 |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "dimensions": [ { object ( |
필드 | |
---|---|
dimensions[] |
요청 및 표시된 측정기준입니다. |
metrics[] |
요청 및 표시된 측정항목입니다. |
dateRanges[] |
읽을 데이터의 기간입니다. 여러 기간이 요청되면 각 응답 행에 0을 기반으로 하는 기간 색인이 포함됩니다. 두 기간이 겹치는 경우, 겹치는 날짜의 이벤트 데이터가 두 기간의 응답 행에 포함됩니다. 동질 집단 요청에서 이 |
dimensionFilter |
측정기준 필터를 사용하면 보고서에서 특정 측정기준 값만 요청할 수 있습니다. 자세한 내용은 측정기준 필터의 기본사항에 나온 예를 참고하세요. 이 필터에서는 측정항목을 사용할 수 없습니다. |
metricFilter |
측정항목의 필터 절입니다. SQL의 have-clause와 마찬가지로 보고서의 행을 집계한 후에 적용됩니다. 이 필터에서는 측정기준을 사용할 수 없습니다. |
offset |
시작 행의 행 수입니다. 첫 번째 행은 0행으로 계산됩니다. 페이징할 때 첫 번째 요청은 오프셋을 지정하지 않습니다. 또는 이와 동등하게 오프셋을 0으로 설정합니다. 첫 번째 요청은 행의 처음 페이지로 나누기 매개변수에 관한 자세한 내용은 페이지로 나누기를 참고하세요. |
limit |
반환할 행의 개수입니다. 지정하지 않으면 10,000행이 반환됩니다. API는 요청 수에 관계없이 요청당 최대 250,000개의 행을 반환합니다. 측정기준 값이 페이지로 나누기 매개변수에 관한 자세한 내용은 페이지로 나누기를 참고하세요. |
metricAggregations[] |
측정항목 집계 집계된 측정항목 값은 dimensionValues가 'RESERVED_(MetricAggregation)'으로 설정된 행에 표시됩니다. |
orderBys[] |
응답에서 행이 정렬되는 방식을 지정합니다. |
currencyCode |
'AED', 'USD', 'JPY'와 같은 ISO4217 형식의 통화 코드입니다. 필드가 비어 있으면 보고서에서는 속성의 기본 통화를 사용합니다. |
cohortSpec |
이 요청과 연결된 동질 집단 그룹입니다. 요청에 동질 집단 그룹이 있는 경우 '동질 집단' 차원이 있어야 합니다. |
keepEmptyRows |
false이거나 지정되지 않은 경우 모든 측정항목이 0인 각 행이 반환되지 않습니다. true인 경우 필터에 의해 별도로 삭제되지 않는 경우 이러한 행이 반환됩니다. 이 예를 들어 속성이 |
returnPropertyQuota |
이 애널리틱스 속성의 할당량의 현재 상태를 반환할지 여부를 전환합니다. 할당량은 PropertyQuota에 반환됩니다. |
comparisons[] |
선택사항입니다. 요청 및 표시된 비교 구성입니다. 응답에서 비교 열을 수신하기 위해 요청에 비교 필드만 있으면 됩니다. |
응답 본문
성공한 경우 응답 본문에 RunReportResponse
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics