¿Qué es la API de metadatos? - Descripción general

En este documento, se proporciona una descripción general de la API de Google Analytics Metadata. Para obtener una referencia detallada de la API, lee la Referencia de la API.

Introducción

La API de metadatos muestra la lista y los atributos de las columnas (es decir, dimensiones y métricas) expuestas en las API de informes de Google Analytics. Los atributos que se muestran incluyen el nombre de la IU, la descripción, la compatibilidad con segmentos y más.

Puedes usar la API de metadatos para lo siguiente:

  • Descubre automáticamente columnas nuevas
  • Accede a todos los atributos de dimensiones y métricas para las APIs de informes de Google Analytics

Consulta una respuesta de la API de metadatos en tiempo real y obtén información para usarla en la Guía para desarrolladores.

Descripción general de conceptos

Los conceptos fundamentales subyacentes de la API de metadatos son los siguientes:

Columna

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

Trabajar con la API

Cuando consultas la API, debes especificar el tipo de informe del que te interesa recuperar metadatos. La respuesta de la API incluirá una colección de todas las columnas (es decir, dimensiones y métricas) disponibles para ese tipo de informe. Lee la Guía de referencia de la API de metadatos para obtener más información sobre la respuesta de la API y los ejemplos de código, y la Guía para desarrolladores de la API de metadatos si quieres obtener detalles sobre cómo trabajar con la API.

Acceso a la API

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

Políticas de cuotas y baja

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

Para obtener detalles sobre cómo se controlan los cambios en las columnas de la API de informes (es decir, dimensiones y métricas), lee la Política de Baja de Datos. Si quieres obtener información sobre cómo se puede usar la API de metadatos para buscar columnas obsoletas, consulta la Guía para desarrolladores de la API de metadatos.