本文說明核心報告和中繼資料 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 中移除，且針對報表 API 中的資料欄查詢查詢會導致
400 Bad Request錯誤。
屬性移除
從 Metadata API 中移除屬性時：
- 中繼資料 API 變更記錄將會更新，顯示有關移除屬性的詳細資料。
- 相關屬性會繼續在 Metadata API 中提供至少 6 個月。
- 6 個月後，屬性會從 Metadata API 移除。
群組
有時候，您必須變更群組或資料欄的順序。發生這種情況時：
- 中繼資料 API 變更記錄將會更新，並提供群組名稱和排序變更的詳細資料。