В этой статье описывается доступ к данным веб-ресурса с использованием Management API.
Введение
Веб-ресурсы располагаются на втором уровне в иерархии аккаунта Google Analytics. Каждый веб-ресурс имеет один родительский аккаунт и дочернюю коллекцию из одного или несколько представлений (профилей).
- Подробнее о том, как веб-ресурсы связаны с другими объектами Management API overview guide to understand how web properties relate to other Management API entities.
- Общая информация о веб-ресурсах в руководстве по аккаунтам и представлениям (профилям).
Именно на уровне веб-ресурса Google Analytics осуществляется сбор данных. Например, при добавлении кода отслеживания на веб-сайт или в мобильное приложение необходимо указать идентификатор веб-ресурса в формате UA-xxxxx-y
. Он указывает на аккаунт Google Analytics, в котором хранятся данные.
Подготовка к работе
- Java;
- Python;
- PHP.
- Клиентские библиотеки. На этой странице представлены клиентские библиотеки для всех языков программирования, которые поддерживает этот API.
- Справочное руководство по интерфейсу API и доступу к данным без использования клиентских библиотек.
В каждой библиотеке реализован один объект службы Google Analytics
, который обеспечивает доступ ко всем данным Management API. Чтобы создать объект службы, обычно нужно выполнить следующие действия:
- Зарегистрируйте приложение в Google Developers Console.
- Разрешите доступ к Google Analytics.
- Создайте служебный объект
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, вы найдете в справке.
Java
Google Analytics API – пример на основе клиентской библиотеки Java.
Python
Google Analytics API – пример на основе клиентской библиотеки Python.
PHP
Google Analytics API – пример на основе клиентской библиотеки PHP.