En este documento, se describe la política de baja de datos de las APIs principales de informes y metadatos.
Descripción general
Las dimensiones y métricas (columnas) se usan para realizar consultas en las APIs de informes de Google Analytics. A veces, es necesario agregar, quitar o cambiar el nombre de estas columnas. La política de baja de datos se proporciona para aumentar la transparencia sobre cómo se producen estos cambios.
Todos los cambios en la columna se comunicarán a través de los registros de cambios y la API de metadatos se actualizará automáticamente para reflejar estos cambios.
Qué cubre esta política
Esta política abarca las dimensiones y métricas expuestas por las APIs públicas. No se abarca la solicitud a la API (parámetros de consulta), la respuesta de la API, los valores que muestra la API ni las combinaciones válidas de dimensiones y métricas.
Datos nuevos
Cuando se agregan columnas nuevas a una API, ocurre lo siguiente:
- El registro de cambios de la API correspondiente se actualizará con detalles sobre las nuevas columnas.
- Las columnas estarán disponibles en la API de metadatos.
Eliminación de Datos
Cuando se quitan columnas de una API, ocurre lo siguiente:
- El registro de cambios de la API correspondiente se actualizará con los detalles sobre las columnas que se quitarán.
- En la API de metadatos, el atributo
status
de la columna se establecerá enDEPRECATED
. - Las columnas seguirán funcionando en las consultas de informes durante un mínimo de 6 meses.
- Después de 6 meses, las columnas se quitarán de la
API de metadatos y
si consultas esas columnas en la API de informes, se mostrará un error
400 Bad Request
.
Cambio de nombre de los datos
Cuando se cambia el nombre de las columnas, sucede lo siguiente:
- El registro de cambios de la API correspondiente se actualizará con detalles sobre las columnas originales y de reemplazo.
- En la API de metadatos
, el atributo
status
de la columna original se establecerá enDEPRECATED
y el atributoreplacedBy
se establecerá en el ID de la columna de reemplazo. - Las columnas originales seguirán funcionando en las consultas de informes durante un mínimo de 6 meses.
- Después de 6 meses, las columnas originales se quitarán de la API de metadatos y, si consultas estas columnas en la API de informes, se mostrará un error
400 Bad Request
.
Eliminación de atributos
Cuando se quitan atributos de la API de metadatos, ocurre lo siguiente:
- El registro de cambios de la API de Metadata se actualizará con detalles sobre los atributos que se quitarán.
- Los atributos seguirán estando disponibles en la API de metadatos durante un mínimo de 6 meses.
- Después de 6 meses, se quitarán los atributos de la API de metadatos.
Grupos
A veces, es necesario cambiar el nombre de un grupo o el orden de las columnas. Cuando esto ocurre:
- El registro de cambios de la API de Metadata se actualizará con detalles sobre el nombre del grupo y los cambios en el orden.