API управления Google Analytics обеспечивает программный доступ к учетным записям, ресурсам и представлениям. В этом документе описывается, как использовать различные ресурсы API для настройки вашей учетной записи Google Analytics.
Введение
Существует два распространенных случая использования Management API, когда дело доходит до настройки вашей учетной записи Google Analytics. Во-первых, это необходимость быстрого получения сводной информации об учетных записях полного иерархического дерева учетных записей, свойств и представлений. Второй — внести конкретные изменения в конфигурацию .
Сводка по счету
Конечная точка «Сводки учетных записей» предоставляет простой способ получить упрощенную информацию об учетных записях, свойствах и представлениях Google Analytics для авторизованного пользователя с помощью одного и быстрого запроса.
Сводные данные по счетам можно использовать для построения индекса иерархии счетов. Приложения, которые интегрируются с Google Analytics, обычно предоставляют пользователям интерфейс для выбора учетной записи, ресурса и представления. С помощью одного запроса к API вы можете получить всю необходимую информацию для создания такого селектора. Пример см. в Query Explorer и примерах кода на Github .
Подробные сведения и примеры кода см. в справочнике по ресурсам «Сводки учетных записей» и справочнике по методу списка .
Конфигурация учетной записи
В отличие от сводок по учетным записям, когда вы используете метод списка для ресурсов Account , Property и View , API возвращает полную информацию для каждого ресурса.
Счета
Поскольку учетные записи объектов верхнего уровня важны, поскольку для каждого запроса API более низкого уровня требуется идентификатор учетной записи. API управления позволяет выполнять операции со списками только для учетных записей. В ответе API следует отметить свойство childlink , которое отправляет запрос API для всех дочерних веб-ресурсов .
Характеристики
Объект второго уровня, также называемый веб-свойствами, важен, поскольку весь сбор данных происходит на этом уровне. Например, когда вы добавляете код отслеживания на веб-сайт или в мобильное приложение, вы должны указать идентификатор, который выглядит как UA-XXXXX-Y . Этот идентификатор называется идентификатором ресурса или идентификатором отслеживания и определяет, в каком аккаунте хранятся данные Google Analytics. Вы можете использовать API для создания или обновления свойств. Подробную информацию и примеры кода см. в ресурсе свойств .
Взгляды
Представления (профили) являются третьим уровнем в иерархии учетной записи, поскольку на этом уровне создаются отчеты. Core Reporting API использует идентификатор представления (профиля) в качестве ключевого параметра, определяющего, из какого представления следует получать данные. Помимо уровня отчетности, многие другие ресурсы либо связаны с этим ресурсом, либо являются его дочерними элементами, например цели , эксперименты , полные отчеты и ссылки на фильтры . Вы можете использовать API для создания или обновления представлений. Подробную информацию и примеры кода см. в ресурсе представления (профиля) .
Следующие шаги
Прочитав это руководство, вы должны хорошо понимать, как использовать Management API для перемещения и управления различными объектами конфигурации учетной записи. В следующем руководстве будет описано, как использовать API для управления пользователями .