Method: properties.checkCompatibility

這個相容性方法會列出可加入報表請求並維持相容性的維度和指標。如果要求的維度和指標不相容，此方法就會失敗。

在 Google Analytics (分析) 中，如果報表要求不相容的維度和/或指標，報表就會失敗。在這種情況下，您必須從不相容的報表中移除維度和/或指標，直到報表相容為止。

「即時」和「核心」報表有不同的相容性規則。這個方法可檢查核心報表的相容性。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
property

string

Google Analytics (分析) GA4 資源 ID，其中包含追蹤事件的相關資料。詳情請參閱「查看資源 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)

這項指標的相容性。如果相容性為「相容性」，系統就能成功將這項指標加到報表中。