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 has-clause와 비슷하게 보고서 행을 집계한 후 적용됩니다. 이 필터에 측정기준을 사용할 수 없습니다. |
offset |
시작 행의 행 수입니다. 첫 번째 행은 0행으로 계산됩니다. 페이징할 때 첫 번째 요청은 오프셋을 지정하지 않습니다. 즉, 오프셋을 0으로 설정합니다. 첫 번째 요청은 행의 처음 이러한 페이지로 나누기 매개변수에 대한 자세한 내용은 페이지로 나누기를 참고하세요. |
limit |
반환할 행 수입니다. 지정하지 않으면 10,000개의 행이 반환됩니다. API는 요청하는 횟수에 관계없이 요청당 최대 250,000개의 행을 반환합니다. 측정기준 값이 이러한 페이지로 나누기 매개변수에 대한 자세한 내용은 페이지로 나누기를 참고하세요. |
metricAggregations[] |
측정항목 집계. 집계된 측정항목 값은dimensionValues가 'RESERVED_(MetricAggregation)'으로 설정된 행에 표시됩니다. |
orderBys[] |
응답에서 행이 정렬되는 방식을 지정합니다. |
currencyCode |
ISO4217 형식의 통화 코드입니다(예: 'AED', 'USD', 'JPY'). 필드가 비어 있으면 보고서에서 속성의 기본 통화가 사용됩니다. |
cohortSpec |
이 요청과 관련된 동질 집단 그룹입니다. 요청에 동질 집단 그룹이 있는 경우 '동질 집단' 측정기준이 있어야 합니다. |
keepEmptyRows |
false이거나 지정되지 않은 경우 모든 측정항목이 0인 각 행이 반환되지 않습니다. true인 경우 필터에 의해 별도로 삭제되지 않은 행이 반환됩니다. 이 예를 들어 속성에서 |
returnPropertyQuota |
이 애널리틱스 속성 할당량의 현재 상태를 반환할지 여부를 지정합니다. 할당량은 PropertyQuota에 반환됩니다. |
comparisons[] |
선택사항입니다. 요청되고 표시되는 비교의 구성입니다. 요청에 비교 필드만 있으면 응답에서 비교 열을 수신할 수 있습니다. |
응답 본문
성공한 경우 응답 본문에 RunReportResponse
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics