Method: properties.checkCompatibility

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

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

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

HTTP 요청

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

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

경로 매개변수

매개변수
property

string

이벤트가 추적되는 Google 애널리틱스 GA4 속성 식별자입니다. 자세한 내용은 속성 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)

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

MetricCompatibility

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

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

object (MetricMetadata)

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

enum (Compatibility)

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