Data Deprecation Policy for Google Analytics APIs

This document describes the data deprecation policy for the Core
Reporting and Metadata APIs.

Overview

Dimensions and metrics (columns) are used to query the Google Analytics
Reporting APIs. At times it is necessary to add, remove, or rename these
columns. The data deprecation policy is provided to increase transparency
on how these changes take place.

All column changes will be communicated through
changelogs
and the Metadata API
will automatically update to reflect these changes.

What’s Covered By This Policy

This policy covers the dimensions and metrics exposed by public APIs. It
does not cover the API request (query parameters), the API response, the
values returned by the API, or valid combinations of dimensions and metrics.

New Data

When new columns are added to an API:

The changelog of the
corresponding API will be updated with details about the new column(s).