Google Analytics (分析) API 資料廢止政策

本文件說明 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 中移除。

群組

有時必須變更 群組的名稱或資料欄順序。發生這種情況時：