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)

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