本文介绍 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 中移除。
群组
有时,需要更改组的名称或列的排序。出现这种情况时:
- Metadata API 变更日志将更新有关组名称和排序变更的详细信息。