Política de desactivación de datos para las API de Google Analytics

En este documento se describe la política de desactivación de datos de las API de informes centrales y de metadatos.

Descripción general

Las dimensiones y las métricas (columnas) se utilizan para consultar a las API de informes de Google Analytics. En ocasiones, es necesario agregar o eliminar estas columnas, así como cambiarles el nombre. La política de desactivación de datos se proporciona para aumentar la transparencia sobre el modo en que se producen estos cambios.

Todas las modificaciones de columna se comunicarán mediante registros de cambios y la API de metadatos se actualizará automáticamente para reflejar dichos cambios.

Alcance de la política

En esta política se incluyen las dimensiones y las métricas que exponen las API públicas. No incluye la solicitud de API (parámetros de consulta), la respuesta de la API, los valores que devuelve la API o las combinaciones válidas de dimensiones y métricas.

Datos nuevos

Cuando se agregan columnas nuevas a una API:

Eliminación de datos

Cuando se eliminan columnas de una API:

  • Se actualiza el registro de cambios de la API correspondiente con la información sobre las columnas que se van a eliminar.
  • En la API de metadatos, el atributo status de la columna se configura como DEPRECATED.
  • Las columnas seguirán funcionando en las consultas de informes durante un mínimo de seis meses.
  • Después de seis meses, las columnas se eliminarán de la API de metadatos y la consulta de las columnas en la API de informes dará como resultado el error 400 Bad Request.

Cambio de nombre de los datos

Cuando se cambia el nombre de las columnas:

  • Se actualiza el registro de cambios de la API correspondiente con la información sobre las columnas original y de reemplazo.
  • En la API de metadatos, el atributo status de la columna organización se configurará como DEPRECATED y el atributo replacedBy se configurará como el ID de la columna de reemplazo.
  • Las columnas originales seguirán funcionando en las consultas de informe durante un mínimo de seis meses.
  • Después de seis meses, las columnas originales se eliminarán de la API de metadatos y la consulta de las columnas en la API de informes dará como resultado el error 400 Bad Request.

Eliminación de atributos

Cuando se eliminan atributos de la API de metadatos:

  • Se actualiza el registro de cambios de la API de metadatos con la información sobre los atributos que se eliminarán.
  • Los atributos seguirán estando disponibles en la API de metadatos durante un mínimo de seis meses.
  • Después de seis meses, los atributos se eliminarán de la API de metadatos.

Grupos

A veces es necesario cambiar el nombre de un grupo o el orden de las columnas. Si esto ocurre: