Обзор Metadata API

В этой статье приводятся общие сведения о 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, вы узнаете из руководства разработчика.