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

В этой статье описывается, как получить доступ к данным представления (профиля) с помощью Management API.

Введение

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

Именно на уровне представления (профиля) Google Analytics осуществляется работа с отчетами. В каждом запросе к Core Reporting API в параметре ids необходимо указывать идентификатор таблицы, который определяет представление (профиль), содержащее данные. Этот идентификатор возвращается в каждом ресурсе представления (профиля).

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

В этой статье описывается доступ к 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.

Ограничения и свойства представлений (профилей)

Представления (профили) имеют следующие ограничения и свойства:

  • По умолчанию – не более 25 представлений на один ресурс. Вы можете обратиться к менеджеру вашего аккаунта Google с просьбой увеличить этот лимит до 200 или 400 (для обычных и премиум-ресурсов соответственно). По достижении ограничения вы не сможете создавать представления (профили), пока не удалите существующие. При этом ранее созданные представления (профили) вы можете обновлять и использовать . Подробнее об общих квотах и ограничениях...

Примеры кода

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

Примеры кода, демонстрирующие работу с представлениями (профилями), вы найдете в справке по соответствующим методам.

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

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

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