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