Google Analytics(分析)API 数据弃用政策

本文介绍 Core Reporting API 和 Metadata API 数据弃用政策。

概览

查询 Google Analytics(分析)报告 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 属性将会设为 DEPRECATED,而 replacedBy 属性将会设为替换列的 ID。
  • 原始列还可以在报告查询中继续使用至少 6 个月。
  • 6 个月之后,原始列将从 Metadata API 中移除。此时,如果您查询报告 API 中的原始列,将会收到 400 Bad Request 错误。

属性移除

从 Metadata API 中移除属性时:

  • Metadata API 更改日志将会更新,以移除相应属性的详细信息。
  • 这些属性还可以在 Metadata API 中继续使用至少 6 个月。
  • 6 个月之后,这些属性将从 Metadata API 中移除。

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