Qué es la API de metadatos: descripción general

En este documento se proporciona una descripción general de la API de metadatos de Google Analytics. En Referencia de la API puedes consultar una descripción detallada de esta API.

Introducción

La API de metadatos devuelve la lista y los atributos de columnas (es decir, una dimensión o una métrica) expuestos en las API de informes de Google Analytics. Los atributos devueltos son el nombre de la interfaz de usuario, la descripción y la compatibilidad de segmentos, entre otros.

Puedes usar la API de metadatos para:

  • Descubrir automáticamente nuevas columnas.
  • Acceder a todos los atributos de dimensiones y métricas de las API de informes de Google Analytics.

Consulta una respuesta activa de la API de metadatos y aprende a usarla con la Guía para programadores.

Descripción conceptual

Los conceptos fundamentales subyacentes de la API de metadatos son:

Columnas

Un recurso Column en la API de metadatos representa una sola dimensión o métrica, y contiene información como el atributo Id y otros atributos de esa columna. Una colección de recursos Column representa todas las dimensiones y las métricas de una API de informes.

Trabajar con la API

Al consultar la API debes especificar el tipo de informe del que te interesa recuperar los metadatos. La respuesta de la API incluirá una colección de todas las columnas (es decir, las dimensiones y las métricas) que están disponibles en ese tipo de informe. Consulta la Guía de referencia de la API de metadatos para obtener más información sobre la respuesta de la API y ejemplos de código, y la Guía para programadores de la API de metadatos para obtener información detallada sobre cómo trabajar con la API.

Acceso a la API

La API de metadatos no requiere autenticación ni autorización. El único requisito es que tu aplicación se identifique cada vez que envíe una solicitud a la API de Analytics. Para obtener información detallada sobre cómo hacerlo, consulta la sección Acceso a la API de la Guía para programadores.

Políticas de cuota y de desactivación

La API de metadatos gestiona millones de operaciones. Para evitar que el sistema reciba más operaciones de las que pueda gestionar, y para garantizar una distribución equitativa de los recursos del sistema, es necesario emplear un sistema de cuotas. Consulta la guía Límites y cuota para obtener más información.

Para obtener información sobre cómo se gestionan los cambios en las columnas de la API de informes (es decir, las dimensiones y las métricas), consulta la política de desactivación de datos. Si quieres obtener información sobre cómo se puede usar la API de metadatos para comprobar las columnas obsoletas, consulta la guía de programadores de la API de metadatos.