Google Analytics（分析）API 数据弃用政策

本文介绍 Core Reporting API 和 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 中移除。

群组

有时，需要更改组的名称或列的排序。出现这种情况时：