En este documento, se describe la política de baja de datos para las API de informes y metadatos principales.
Descripción general
Las dimensiones y métricas (columnas) se usan para consultar las API 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 ocurren estos cambios.
Todos los cambios de columna se comunicarán mediante 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 las métricas que exponen las API públicas. No abarca la solicitud a la API (parámetros de búsqueda), 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, sucede lo siguiente:
- El registro de cambios de la API correspondiente se actualizará con los detalles de las columnas nuevas.
- Las columnas estarán disponibles en la API de metadatos.
Eliminación de datos
Cuando se quitan columnas de una API, sucede lo siguiente:
- El registro de cambios de la API correspondiente se actualizará con los detalles de las columnas que se quitarán.
- En la API de metadatos, el atributo de la columna
status
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 las consultas sobre las columnas en la API de informes generarán un error
400 Bad Request
.
Cambio de nombre de los datos
Cuando se cambia el nombre de las columnas:
- El registro de cambios de la API correspondiente se actualizará con los detalles de las columnas original 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 las consultas sobre las columnas en la API de informes generarán un error
400 Bad Request
.
Eliminación de atributos
Cuando se quitan atributos de la API de metadatos:
- El registro de cambios de la API de metadatos se actualizará con los detalles de los atributos que se quitarán.
- Los atributos seguirán disponibles en la API de metadatos durante un mínimo de 6 meses.
- Después de 6 meses, los atributos se quitarán 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 metadatos se actualizará con los detalles del nombre del grupo y los cambios de orden.