В этой статье описывается, как получить доступ к данным представления (профиля) с помощью Management API.
Введение
Представление (профиль) располагается на третьем уровне в иерархии аккаунта Google Analytics. Каждое представление (профиль) имеет один родительский веб-ресурс и коллекцию с любым количеством дочерних целей.
- Подробнее о том, как представления (профили) связаны с другими объектами Management API.
- Общая информация о представлениях (профилях) в руководстве по аккаунтам и представлениям (профилям).
Именно на уровне представления (профиля) Google Analytics осуществляется работа с отчетами. В каждом запросе к Core Reporting API в параметре ids
необходимо указывать идентификатор таблицы, который определяет представление (профиль), содержащее данные.
Этот идентификатор возвращается в каждом ресурсе представления (профиля).
Подготовка к работе
- 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.
Ограничения и свойства представлений (профилей)
Представления (профили) имеют следующие ограничения и свойства:
- По умолчанию – не более 25 представлений на один ресурс. Вы можете обратиться к менеджеру вашего аккаунта Google с просьбой увеличить этот лимит до 200 или 400 (для обычных и премиум-ресурсов соответственно). По достижении ограничения вы не сможете создавать представления (профили), пока не удалите существующие. При этом ранее созданные представления (профили) вы можете обновлять и использовать . Подробнее об общих квотах и ограничениях...
Примеры кода
В Management API для работы с представлениями (профилями) авторизованного пользователя применяются методы list, get, insert, update, patch и delete. Каждый из них использует объект службы Google Analytics
, создание которого описывается в разделе Прежде чем начать.
Примеры кода, демонстрирующие работу с представлениями (профилями), вы найдете в справке по соответствующим методам.
- list – выводит список доступных пользователю представлений (профилей).
- get – получает доступное пользователю представление (профиль).
- insert – создает новое представление (профиль).
- patch – обновляет существующее представление (профиль). Этот метод поддерживает семантику PATCH.
- update – обновляет существующее представление (профиль).
- delete – удаляет представление (профиль).
Пример приложения
Готовый пример, демонстрирующий работу с данными в Management API, вы найдете в справке.
Java
Google Analytics API – пример на основе клиентской библиотеки Java.
Python
Google Analytics API – пример на основе клиентской библиотеки Python.
PHP
Google Analytics API – пример на основе клиентской библиотеки PHP.