Method: properties.batchRunPivotReports

여러 피벗 보고서를 일괄적으로 반환합니다. 모든 보고서는 동일한 Google 애널리틱스 속성에 대한 보고서여야 합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
property

string

이벤트가 추적되는 Google 애널리틱스 속성 식별자입니다. 본문이 아닌 URL 경로에 지정됩니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요. 이 속성은 일괄 처리에 지정해야 합니다. RunPivotReportRequest 내의 속성은 지정되지 않거나 이 속성과 일치할 수 있습니다.

예: properties/1234

요청 본문

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

JSON 표현 
{
  "requests": [
    {
      object (RunPivotReportRequest)
    }
  ]
}
필드
requests[]

object (RunPivotReportRequest)

개별 요청 각 요청에는 별도의 피벗 보고서 응답이 있습니다. 각 일괄 요청은 최대 5개의 요청을 허용합니다.

응답 본문

여러 피벗 보고서가 포함된 일괄 응답입니다.

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

JSON 표현 
{
  "pivotReports": [
    {
      object (RunPivotReportResponse)
    }
  ],
  "kind": string
}
필드
pivotReports[]

object (RunPivotReportResponse)

개별 응답 각 응답에는 별도의 피벗 보고서 요청이 있습니다.
kind

string

이 메시지가 어떤 종류의 리소스인지 식별합니다. 이 kind는 항상 고정 문자열 'analyticsData#batchRunPivotReports'입니다. JSON에서 응답 유형을 구분하는 데 유용합니다.

승인 범위

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

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

RunPivotReportRequest

피벗 보고서 생성 요청입니다.

JSON 표현 
{
  "property": string,
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
필드
property

string

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

예: properties/1234
dimensions[]

object (Dimension)

요청된 크기입니다. 정의된 모든 측정기준은 dimensionExpression, dimensionFilter, pivots, orderBys 중 하나에 의해 사용되어야 합니다.
metrics[]

object (Metric)

요청된 측정항목입니다. 하나 이상의 측정항목을 지정해야 합니다. 정의된 모든 측정항목은 metric_expression, metricFilter, orderBys 중 하나를 사용하여야 합니다.
dateRanges[]

object (DateRange)

보고서의 이벤트 데이터를 가져올 기간입니다. 기간을 여러 개 지정하면 각 기간의 이벤트 데이터가 보고서에 사용됩니다. 필드 이름이 'dateRange'인 특수 측정기준을 피벗의 필드 이름에 포함할 수 있습니다. 포함하면 보고서에서 기간 간에 비교합니다. 동질 집단 요청에서 이 dateRanges는 지정되지 않아야 합니다.
pivots[]

object (Pivot)

열 또는 행의 보고서 측정기준의 시각적 형식을 설명합니다. 모든 피벗의 필드 이름 (측정기준 이름)의 합집합은 측정기준에 정의된 측정기준 이름의 하위 집합이어야 합니다. 두 피벗이 동일한 측정기준을 공유할 수는 없습니다. 측정기준은 피벗에 표시되는 경우에만 표시됩니다.
dimensionFilter

object (FilterExpression)

측정기준의 필터 절입니다. 이 필터에서 측정기준을 사용하려면 요청해야 합니다. 이 필터에서는 측정항목을 사용할 수 없습니다.
metricFilter

object (FilterExpression)

측정항목의 필터 절입니다. SQL having 절과 마찬가지로 집계 후 단계에서 적용됩니다. 이 필터에서 사용하려면 측정항목을 요청해야 합니다. 이 필터에서는 측정기준을 사용할 수 없습니다.
currencyCode

string

ISO4217 형식의 통화 코드입니다(예: 'AED', 'USD', 'JPY'). 이 필드가 비어 있으면 보고서에 속성의 기본 통화가 사용됩니다.
cohortSpec

object (CohortSpec)

이 요청과 연결된 사용자 집단 그룹입니다. 요청에 사용자 집단 그룹이 있는 경우 '사용자 집단' 측정기준이 있어야 합니다.
keepEmptyRows

boolean

false이거나 지정되지 않은 경우 모든 측정항목이 0인 각 행이 반환되지 않습니다. 이 값이 true이면 필터에 의해 별도로 삭제되지 않은 행이 반환됩니다.

이 keepEmptyRows 설정과 관계없이 Google 애널리틱스 속성에서 기록된 데이터만 보고서에 표시될 수 있습니다.

예를 들어 속성에서 purchase 이벤트를 기록하지 않으면 eventName 측정기준 및 eventCount 측정항목에 대한 쿼리에 eventName: 'purchase' 및 eventCount: 0 행이 없습니다.
returnPropertyQuota

boolean

이 Google 애널리틱스 속성의 현재 할당량 상태를 반환할지 전환합니다. 할당량은 PropertyQuota에 반환됩니다.
comparisons[]

object (Comparison)

선택사항입니다. 요청되고 표시된 비교 구성입니다. 요청에 비교 필드와 비교 측정기준이 모두 있어야 응답에 비교 열이 표시됩니다.