- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- RunPivotReportRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
여러 피벗 보고서를 일괄적으로 반환합니다. 모든 보고서는 동일한 GA4 속성에 대한 것이어야 합니다.
HTTP 요청
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
property |
이벤트가 추적되는 Google 애널리틱스 GA4 속성 식별자입니다. 본문이 아닌 URL 경로에 지정됩니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요. 배치에 이 속성을 지정해야 합니다. RunPivotReportRequest 내의 속성이 지정되지 않았거나 이 속성과 일치할 수 있습니다. 예: properties/1234 |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"requests": [
{
object ( |
필드 | |
---|---|
requests[] |
개별 요청. 각 요청에는 별도의 피벗 보고서 응답이 있습니다. 각 일괄 요청에는 최대 5개의 요청이 허용됩니다. |
응답 본문
여러 피벗 보고서가 포함된 일괄 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"pivotReports": [
{
object ( |
필드 | |
---|---|
pivotReports[] |
개별 응답 각 응답에는 별도의 피벗 보고서 요청이 있습니다. |
kind |
이 메시지가 어떤 리소스인지 식별합니다. 이 |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunPivotReportRequest
피벗 보고서 생성 요청입니다.
JSON 표현 |
---|
{ "property": string, "dimensions": [ { object ( |
필드 | |
---|---|
property |
이벤트가 추적되는 Google 애널리틱스 GA4 속성 식별자입니다. 본문이 아닌 URL 경로에 지정됩니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요. 일괄 요청 내에서 이 속성은 지정되지 않거나 일괄 수준 속성과 일치해야 합니다. 예: properties/1234 |
dimensions[] |
요청된 크기입니다. 정의된 모든 측정기준은 dimensionExpression, dimensionFilter, pivots, orderBys 중 하나에서 사용되어야 합니다. |
metrics[] |
요청된 측정항목입니다. 측정항목을 하나 이상 지정해야 합니다. 정의된 모든 측정항목은 metric_expression, metricFilter, orderBys 중 하나에서 사용해야 합니다. |
dateRanges[] |
보고서의 이벤트 데이터를 검색할 기간입니다. 여러 기간이 지정된 경우 각 기간의 이벤트 데이터가 보고서에 사용됩니다. 필드 이름이 'dateRange'인 특수 측정기준 피벗의 필드 이름에 포함될 수 있습니다. 포함된 경우 보고서에서 두 기간을 비교합니다. 동질 집단 요청에서 이 |
pivots[] |
열 또는 행으로 표시된 보고서 측정기준의 시각적 형식을 설명합니다. 모든 피벗에서 fieldNames (측정기준 이름)의 합집합은 측정기준에 정의된 측정기준 이름의 하위 집합이어야 합니다. 두 개의 피벗은 하나의 측정기준을 공유할 수 없습니다. 측정기준은 피벗에 표시되는 경우에만 표시됩니다. |
dimensionFilter |
측정기준의 필터 절입니다. 이 필터에 사용하려면 측정기준을 요청해야 합니다. 이 필터에서는 측정항목을 사용할 수 없습니다. |
metricFilter |
측정항목의 필터 절입니다. SQL의 조건과 마찬가지로 집계 후 단계에서 적용됩니다. 이 필터에서 사용하려면 측정항목을 요청해야 합니다. 이 필터에서는 측정기준을 사용할 수 없습니다. |
currencyCode |
'AED', 'USD', 'JPY'와 같은 ISO4217 형식의 통화 코드입니다. 필드가 비어 있으면 보고서에서는 속성의 기본 통화를 사용합니다. |
cohortSpec |
이 요청과 연결된 동질 집단 그룹입니다. 요청에 동질 집단 그룹이 있는 경우 '동질 집단' 차원이 있어야 합니다. |
keepEmptyRows |
false이거나 지정되지 않은 경우 모든 측정항목이 0인 각 행이 반환되지 않습니다. true인 경우 필터에 의해 별도로 삭제되지 않는 경우 이러한 행이 반환됩니다. 이 예를 들어 속성이 |
returnPropertyQuota |
이 애널리틱스 속성의 할당량의 현재 상태를 반환할지 여부를 전환합니다. 할당량은 PropertyQuota에 반환됩니다. |
comparisons[] |
선택사항입니다. 요청 및 표시된 비교 구성입니다. 응답에서 비교 열을 받으려면 요청에 비교 필드와 비교 측정기준이 모두 필요합니다. |