Method: properties.checkCompatibility

이 호환성 메서드는 보고서 요청에 추가하고 호환성을 유지할 수 있는 측정기준 및 측정항목을 나열합니다. 요청의 측정기준과 측정항목이 호환되지 않으면 이 메서드가 실패합니다.

Google 애널리틱스에서 호환되지 않는 측정기준 또는 측정항목을 요청하면 보고서가 실패합니다. 이 경우 보고서가 호환될 때까지 호환되지 않는 보고서에서 측정기준 또는 측정항목을 삭제해야 합니다.

실시간 보고서와 핵심 보고서의 호환성 규칙은 다릅니다. 이 메서드는 핵심 보고서의 호환성을 확인합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
property

string

이벤트가 추적되는 Google 애널리틱스 속성 식별자입니다. 자세한 내용은 속성 ID를 찾을 수 있는 위치를 참고하세요. property는 runReport 요청과 동일한 값이어야 합니다.

예: properties/1234

요청 본문

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

JSON 표현 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "compatibilityFilter": enum (Compatibility)
}
필드
dimensions[]

object (Dimension)

이 보고서의 측정기준입니다. dimensions는 runReport 요청과 동일한 값이어야 합니다.
metrics[]

object (Metric)

이 보고서의 측정항목 metrics는 runReport 요청과 동일한 값이어야 합니다.
dimensionFilter

object (FilterExpression)

측정기준의 필터 절입니다. dimensionFilter는 runReport 요청과 동일한 값이어야 합니다.
metricFilter

object (FilterExpression)

측정항목의 필터 절입니다. metricFilter는 runReport 요청과 동일한 값이어야 합니다.
compatibilityFilter

enum (Compatibility)

응답의 측정기준과 측정항목을 이 호환성에만 필터링합니다. 호환되는 측정기준 및 측정항목만 반환하기 위해 일반적으로 ”compatibilityFilter”: “COMPATIBLE”로 사용됩니다.

응답 본문

각 측정기준 및 측정항목의 호환성과 관련된 호환성 응답입니다.

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

JSON 표현 
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
필드
dimensionCompatibilities[]

object (DimensionCompatibility)

각 측정기준의 호환성입니다.
metricCompatibilities[]

object (MetricCompatibility)

각 측정항목의 호환성

승인 범위

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

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

호환성

단일 측정기준 또는 측정항목의 호환성 유형입니다.

열거형
COMPATIBILITY_UNSPECIFIED 지정되지 않은 호환성입니다.
COMPATIBLE 측정기준 또는 측정항목이 호환됩니다. 이 측정기준 또는 측정항목은 보고서에 추가할 수 있습니다.
INCOMPATIBLE 측정기준 또는 측정항목이 호환되지 않습니다. 이 측정기준 또는 측정항목을 보고서에 추가할 수 없습니다.

DimensionCompatibility

단일 측정기준의 호환성입니다.

JSON 표현 
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
필드
dimensionMetadata

object (DimensionMetadata)

측정기준 메타데이터에는 이 호환성 정보의 API 이름이 포함됩니다. 측정기준 메타데이터에는 UI 이름, 설명과 같은 다른 유용한 정보도 포함됩니다.
compatibility

enum (Compatibility)

이 측정기준의 호환성입니다. 호환성이 COMPATIBLE인 경우 이 측정기준을 보고서에 추가할 수 있습니다.

MetricCompatibility

단일 측정항목의 호환성입니다.

JSON 표현 
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
필드
metricMetadata

object (MetricMetadata)

측정항목 메타데이터에는 이 호환성 정보의 API 이름이 포함됩니다. 측정항목 메타데이터에는 UI 이름, 설명과 같은 다른 유용한 정보도 포함되어 있습니다.
compatibility

enum (Compatibility)

이 측정항목의 호환성입니다. 호환성이 COMPATIBLE인 경우 이 측정항목을 보고서에 추가할 수 있습니다.