Management API: руководство по веб-ресурсам для разработчика

В этой статье описывается доступ к данным веб-ресурса с использованием Management API.

Введение

Веб-ресурсы располагаются на втором уровне в иерархии аккаунта Google Analytics. Каждый веб-ресурс имеет один родительский аккаунт и дочернюю коллекцию из одного или несколько представлений (профилей).

Именно на уровне веб-ресурса Google Analytics осуществляется сбор данных. Например, при добавлении кода отслеживания на веб-сайт или в мобильное приложение необходимо указать идентификатор веб-ресурса в формате UA-xxxxx-y. Он указывает на аккаунт Google Analytics, в котором хранятся данные.

Подготовка к работе

В этой статье описывается доступ к Google Analytics API с использованием следующих языков программирования:
  • Java;
  • Python;
  • PHP.

  • Клиентские библиотеки. На этой странице представлены клиентские библиотеки для всех языков программирования, которые поддерживает этот API.
  • Справочное руководство по интерфейсу API и доступу к данным без использования клиентских библиотек.

В каждой библиотеке реализован один объект службы Google Analytics, который обеспечивает доступ ко всем данным Management API. Чтобы создать объект службы, обычно нужно выполнить следующие действия:

  1. Зарегистрируйте приложение в Google Developers Console.
  2. Разрешите доступ к Google Analytics.
  3. Создайте служебный объект Google Analytics.

Если у вас возникли проблемы, сначала изучите вводное руководство по Google Analytics API, в котором описывается, с чего нужно начинать создание приложения на его основе. После этого вы сможете применять полученные знания в реальных условиях.

Следующий фрагмент продолжает код, представленный на шаге 3, "Создание объекта службы Google Analytics", и содержит переменную для хранения авторизованного объекта службы.

Java

Analytics analytics = // Read Hello Analytics Tutorial for details.

Python;

analytics = # Read Hello Analytics Tutorial for details.

PHP

$client = // Read Hello Analytics Tutorial for details.

// Return results as objects.
$client->setUseObjects(true);

$analytics = new apiAnalyticsService($client);

Библиотека PHP возвращает все результаты API в виде ассоциативного массива. Чтобы получить фактические объекты, можно вызвать метод клиента useObject, показанный в предыдущем примере.

Приложение использует созданный объект службы Google Analytics для выполнения запросов к Management API.

Примечание. Этот же объект службы Google Analytics можно использовать для доступа к Core Reporting API.

Использование тестового аккаунта

Прежде чем работать с веб-ресурсами в Management API, мы рекомендуем реализовать и проверить код с использованием тестового аккаунта. Это позволит избежать случайного изменения активных ресурсов. После успешной проверки код можно использовать в действующих аккаунтах.

Тестовый аккаунт можно создать в разделе "Администратор" веб-интерфейса Google Analytics.

Примеры кода

В Management API для работы с ресурсами авторизованного пользователя применяются методы list, get, insert, update и patch. Каждый из них использует объект службы Google Analytics, создание которого описывается в разделе Прежде чем начать.

Примеры кода, демонстрирующие работу с веб-ресурсами, вы найдете в справке по соответствующим методам.

  • list – выводит список доступных пользователю веб-ресурсов.
  • get – получает доступный пользователю веб-ресурс.
  • insert – создает новый веб-ресурс.
  • patch – обновляет существующий веб-ресурс. Этот метод поддерживает семантику PATCH.
  • update – обновляет существующий веб-ресурс.

Пример приложения

Готовый пример, демонстрирующий работу с данными в Management API, вы найдете в справке.