В этом документе представлен общий обзор API метаданных Google Analytics. Подробную информацию об API можно найти в справочнике API .
Введение
API метаданных возвращает список и атрибуты столбцов (т. е. параметров и показателей), представленных в API отчетов Google Analytics. Возвращаемые атрибуты включают имя пользовательского интерфейса, описание, поддержку сегментов и многое другое.
Вы можете использовать API метаданных, чтобы:
- Автоматически обнаруживать новые столбцы
- Доступ ко всем атрибутам параметров и показателей для API отчетов Google Analytics.
Ознакомьтесь с ответом Metadata API в реальном времени и узнайте, как его использовать, прочитав Руководство для разработчиков .
Концептуальный обзор
Фундаментальными концепциями, лежащими в основе API метаданных, являются:
Столбцы
Ресурс Столбец в API метаданных представляет собой одно измерение или показатель и содержит такую информацию, как Id
и другие атрибуты этого столбца. Коллекция ресурсов Column
представляет все измерения и показатели API отчетов.
Работа с API
При запросе к API вы указываете тип отчета, для которого вы хотите получить метаданные. Ответ API будет включать в себя набор всех столбцов (т. е. параметров и показателей), доступных для этого типа отчета. Прочтите Справочное руководство по API метаданных для получения дополнительной информации об ответах API и примерах кода , а также Руководство для разработчиков API метаданных для получения подробной информации о работе с API.
API-доступ
API метаданных не требует аутентификации и авторизации. Вместо этого единственное требование состоит в том, чтобы ваше приложение идентифицировало себя каждый раз, когда оно отправляет запрос к Analytics API. Подробности о том, как это сделать, см. в разделе «Доступ к API» Руководства для разработчиков .
Политика квот и устаревания
API метаданных обрабатывает миллионы операций. Чтобы защитить систему от получения большего количества операций, чем она может обработать, и обеспечить справедливое распределение системных ресурсов, необходимо использовать систему квот. Для получения более подробной информации прочтите руководство по лимитам и квотам .
Подробную информацию о том, как обрабатываются изменения в столбцах API отчетности (т. е. параметрах и показателях), можно найти в Политике устаревания данных . Чтобы узнать, как можно использовать Metadata API для проверки устаревших столбцов, см. Руководство для разработчиков Metadata API .