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 中移除,透過報表 API 查詢資料欄會導致 400 Bad Request 錯誤。

重新命名資料

重新命名資料欄時:

  • 對應 API 的變更記錄會更新,提供原始和替換資料欄的詳細資料。
  • Metadata API 中,原始資料欄的 status 屬性會設為 DEPRECATEDreplacedBy 屬性會設為替換資料欄的 ID。
  • 原始資料欄在報表查詢中會繼續運作至少 6 個月。
  • 6 個月後,原始資料欄將從 Metadata API 中移除,透過報表 API 查詢資料欄會導致 400 Bad Request 錯誤。

移除屬性

從 Metadata API 中移除 屬性時:

  • Metadata API 變更記錄將更新,針對要移除的屬性提供詳細資料。
  • 屬性在 Metadata API 中的效期至少為 6 個月。
  • 6 個月後,屬性就會從 Metadata API 中移除。

群組

有時您需要變更 群組名稱或資料欄順序。發生這種情況時: