本文件說明 Core Reporting 和 Metadata API 的資料淘汰政策。
總覽
維度和指標 (資料欄) 可用來查詢 Google Analytics (分析) Reporting API。有時必須新增、移除或重新命名這些資料欄。我們提供資料淘汰政策,以更清楚地說明這些變更的執行方式。
所有資料欄變更都會透過變更記錄發布,Metadata API 也會自動更新來反映這些變更。
本政策的適用範圍
這項政策涵蓋公用 API 公開的維度和指標。不在涵蓋 API 要求 (查詢參數)、API 回應、API 傳回的值,或有效的維度和指標組合。
新資料
在 API 中新增資料欄時:
- 相應 API 的變更記錄會更新,加入新資料欄的詳細資料。
- 您可以在 Metadata API 中使用這些資料欄。
資料移除
從 API 中移除資料欄後:
- 相應 API 的變更記錄會更新,加入要移除的資料欄詳細資料。
- 在 Metadata API 中,
status
資料欄屬性會設為DEPRECATED
。 - 這欄會繼續用於報表查詢至少 6 個月。
- 6 個月後,這些資料欄將從 Metadata API 中移除,並在 Reporting API 中查詢資料欄,將導致
400 Bad Request
錯誤。
資料重新命名
重新命名資料欄後:
- 相應 API 的變更記錄會更新為原始資料欄和替換資料欄的詳細資料。
- 在 Metadata API
中,原始資料欄的
status
屬性會設為DEPRECATED
,replacedBy
屬性會設為替換資料欄的 ID。 - 原始資料欄仍會繼續在報表查詢中運作至少 6 個月。
- 6 個月後,原始資料欄將從 Metadata API 中移除,並在 Reporting API 中查詢資料欄,將導致
400 Bad Request
錯誤。
屬性移除
從 Metadata API 移除 屬性後:
- 我們將更新 Metadata API 變更記錄,加入要移除的屬性詳細資料。
- 這些屬性會在 Metadata API 中繼續提供至少 6 個月。
- 6 個月後,這個屬性將從 Metadata API 中移除。
群組
有時必須變更 群組的名稱或資料欄順序。發生這種情況時:
- 我們將更新 Metadata API 變更記錄,加入群組名稱和順序變更的詳細資料。