這種相容性方法會列出可加入報表要求的維度和指標,並維持相容性。如果請求的維度和指標不相容,此方法就無法執行。
在 Google Analytics 中,如果報表要求不相容的維度和/或指標,報表就會失敗。在這種情況下,您必須從不相容的報表中移除維度和/或指標,直到報表相容為止。
「即時」和「核心」報表有不同的相容性規則。這個方法會檢查核心報表的相容性。
HTTP 要求
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:checkCompatibility
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
property |
要追蹤事件的 Google Analytics GA4 資源 ID。詳情請參閱「如何查看資源 ID」一文。 範例:properties/1234 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "dimensions": [ { object ( |
欄位 | |
---|---|
dimensions[] |
這份報表中的維度。 |
metrics[] |
這份報表中的指標。 |
dimensionFilter |
維度的篩選器子句, |
metricFilter |
指標的篩選器子句。 |
compatibilityFilter |
針對回應中的維度和指標,只針對這個相容性進行篩選。通常做為 |
回應主體
相容性回應與各維度的相容性,以及指標。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{ "dimensionCompatibilities": [ { object ( |
欄位 | |
---|---|
dimensionCompatibilities[] |
每個維度的相容性。 |
metricCompatibilities[] |
每個指標的相容性。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
相容性
單一維度或指標的相容性類型。
列舉 | |
---|---|
COMPATIBILITY_UNSPECIFIED |
未指定相容性。 |
COMPATIBLE |
維度或指標相容。此維度或指標可以成功新增至報表。 |
INCOMPATIBLE |
維度或指標不相容。這個維度或指標無法成功新增至報表。 |
DimensionCompatibility
單一維度的相容性。
JSON 表示法 |
---|
{ "dimensionMetadata": { object ( |
欄位 | |
---|---|
dimensionMetadata |
維度中繼資料包含這項相容性資訊的 API 名稱。維度中繼資料也包含其他實用資訊,例如 UI 名稱和說明。 |
compatibility |
此維度的相容性。如果相容性為「相容性」,則這個維度可以成功加入報表。 |
MetricCompatibility
單一指標的相容性。
JSON 表示法 |
---|
{ "metricMetadata": { object ( |
欄位 | |
---|---|
metricMetadata |
指標中繼資料包含這項相容性資訊的 API 名稱。指標中繼資料也包含其他實用資訊,例如 UI 名稱和說明。 |
compatibility |
這項指標的相容性。如果相容性為「相容性」,表示這項指標可以成功加入報表。 |