Справочник по API

Management API

В этом справочном руководстве по Management API версии 3.0 описаны все запросы и ответы, которые применяются при настройке Google Analytics. Общую информацию и сведения о структуре данных вы найдете здесь.

О методах запросов и ответах для отдельных объектов конфигурации рассказывается в соответствующих разделах этого руководства.  Все запросы представлены в формате REST,  а в конце каждой страницы с описанием методов можно выполнить тестовый запрос API Explorer. Для этого достаточно перейти по соответствующей ссылке.

Типы ресурсов

  1. Сводки по аккаунтам
  2. Ссылки на пользователей аккаунта
  3. Аккаунты
  4. Ссылки AdWords
  5. Пользовательские источники данных
  6. Специальные параметры
  7. Специальные показатели
  8. Эксперименты
  9. Фильтры
  10. Цели
  11. Идентификатор клиента
  12. Ссылки на фильтр профиля
  13. Ссылки на пользователей профиля
  14. Аудитории ремаркетинга
  15. Сегменты
  16. Полные отчеты
  17. Загрузки
  18. Представления (профили)
  19. Веб-ресурсы
  20. Ссылки на пользователей веб-ресурса

Сводки по аккаунтам

Подробнее о ресурсах типа "Сводка по аккаунту"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
list GET  /management/accountSummaries Выводит список доступных пользователю сводок по аккаунтам. Они выглядят как дерево простой конфигурации, в котором собраны аккаунты, ресурсы и профили.

Подробнее о ресурсах типа "Ссылка на пользователя аккаунта"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/entityUserLinks/linkId Удаляет пользователя из указанного аккаунта.
insert POST  /management/accounts/accountId/entityUserLinks Добавляет в указанный аккаунт нового пользователя, имеющего менее 100 аккаунтов.
list GET  /management/accounts/accountId/entityUserLinks Выводит список пользователей, связанных с указанным аккаунтом.
update PUT  /management/accounts/accountId/entityUserLinks/linkId Обновляет разрешения существующего пользователя в отношении указанного аккаунта.

Аккаунты

Подробнее о ресурсах типа "Аккаунт"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
list GET  /management/accounts Выводит список всех доступных пользователю аккаунтов.

Подробнее о ресурсах типа "Ссылка AdWords"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Удаляет связь между веб-ресурсом и AdWords.
get GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Возвращает доступную пользователю связь между веб-ресурсом и AdWords.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Создает связь между веб-ресурсом и AdWords.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks Выводит список связей между веб-ресурсом и AdWords для указанного веб-ресурса.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Обновляет существующую связь между веб-ресурсом и AdWords. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId Обновляет существующую связь между веб-ресурсом и AdWords.

Пользовательские источники данных

Подробнее о ресурсах типа "Пользовательский источник данных"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources Выводит список пользовательских источников данных, к которым есть доступ.

Специальные параметры

Подробнее о ресурсах типа "Специальный параметр"…

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Получает доступный пользователю специальный параметр.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Создает новый специальный параметр.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDimensions Выводит список доступных пользователю специальных параметров.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Обновляет существующий специальный параметр. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/customDimensions/customDimensionId Обновляет существующий специальный параметр.

Специальные показатели

Подробнее о ресурсах типа "Специальный показатель"…

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
get GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Получает доступный пользователю специальный показатель.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Создает новый специальный показатель.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customMetrics Выводит список доступных пользователю специальных показателей.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Обновляет существующий специальный показатель. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/customMetrics/customMetricId Обновляет существующий специальный показатель.

Эксперименты

Подробнее о ресурсах типа "Эксперимент"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Удаляет эксперимент.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Возвращает доступный пользователю эксперимент.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Создает эксперимент.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments Выводит список доступных пользователю экспериментов.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Обновляет существующий эксперимент. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId Обновляет существующий эксперимент.

Фильтры

Подробнее о ресурсах типа "Фильтр"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/filters/filterId Удаляет фильтр.
get GET  /management/accounts/accountId/filters/filterId Возвращает доступный пользователю фильтр.
insert POST  /management/accounts/accountId/filters Создает новый фильтр.
list GET  /management/accounts/accountId/filters Выводит список всех фильтров для аккаунта.
patch PATCH  /management/accounts/accountId/filters/filterId Обновляет существующий фильтр. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/filters/filterId Обновляет существующий фильтр.

Цели

Подробнее о ресурсах типа "Цель"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Получает доступную пользователю цель.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Создает новую цель.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals Выводит список доступных пользователю целей.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Обновляет существующую цель. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/goals/goalId Обновляет существующую цель.

Идентификатор клиента

Подробнее о ресурсе Management.clientId можно узнать на этой странице.

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
hashClientId POST  /management/clientId:hashClientId Хеширует идентификатор клиента.

Подробнее о ресурсах типа "Ссылка на фильтр профиля"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Удаляет ссылку на фильтр профиля.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Возвращает отдельную ссылку на фильтр профиля.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Создает новую ссылку на фильтр профиля.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks Выводит список всех ссылок на фильтр профиля.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Обновляет существующую ссылку на фильтр профиля. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks/linkId Обновляет существующую ссылку на фильтр профиля.

Подробнее о ресурсах типа "Ссылка на пользователя профиля"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId Удаляет пользователя из указанного представления (профиля).
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Добавляет нового пользователя в указанное представление (профиль).
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks Выводит список ссылок на пользователей профиля для указанного представления (профиля).
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/entityUserLinks/linkId Обновляет разрешения существующего пользователя в отношении указанного представления (профиля).

Аудитории ремаркетинга

Подробнее о ресурсе Remarketing Audiences читайте на этой странице.

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Delete a remarketing audience.
get GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Получает аудиторию ремаркетинга, к которой у пользователя есть доступ.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences Создает аудиторию ремаркетинга.
list GET  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences Выводит список аудиторий ремаркетинга, к которым у пользователя есть доступ.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Обновляет существующую аудиторию ремаркетинга. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/remarketingAudiences/remarketingAudienceId Обновляет существующую аудиторию ремаркетинга.

Сегменты

Подробнее о ресурсах типа "Сегмент"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
list GET  /management/segments Выводит список доступных пользователю сегментов.

Полные отчеты

Подробнее о ресурсах типа "Полный отчет"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId Удаляет полный отчет.
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports/unsampledReportId Возвращает отдельный полный отчет.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Создает новый полный отчет.
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/unsampledReports Выводит список полных отчетов, доступных пользователю.

Загрузки

Подробнее о ресурсах типа "Загрузка"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
deleteUploadData POST  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/deleteUploadData Удаляет данные, связанные с предыдущей загрузкой.
get GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads/uploadId Выводит список доступных пользователю загрузок.
list GET  /management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads Выводит список доступных пользователю загрузок.
uploadData POST
https://www.googleapis.com/upload/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/customDataSources/customDataSourceId/uploads
Загружает данные в пользовательский источник.

Представления (профили)

Подробнее о ресурсах типа "Представление (профиль)"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Удаляет представление (профиль).
get GET  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Получает доступное пользователю представление (профиль).
insert POST  /management/accounts/accountId/webproperties/webPropertyId/profiles Создает новое представление (профиль).
list GET  /management/accounts/accountId/webproperties/webPropertyId/profiles Выводит список доступных пользователю представлений (профилей).
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Обновляет существующее представление (профиль). Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/profiles/profileId Обновляет существующее представление (профиль).

Веб-ресурсы

Подробнее о ресурсах типа "Веб-ресурс"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
get GET  /management/accounts/accountId/webproperties/webPropertyId Получает ресурс, к которому у пользователя есть доступ.
insert POST  /management/accounts/accountId/webproperties Создает ресурс.
list GET  /management/accounts/accountId/webproperties Создает список ресурсов, к которым у пользователя есть доступ.
patch PATCH  /management/accounts/accountId/webproperties/webPropertyId Обновляет существующий ресурс. Этот метод поддерживает семантику PATCH.
update PUT  /management/accounts/accountId/webproperties/webPropertyId Обновляет существующий ресурс.

Подробнее о ресурсах типа "Ссылка на пользователя веб-ресурса"...

Метод HTTP-запрос Описание
Если не указано иное, URI задаются относительно адреса https://www.googleapis.com/analytics/v3.
delete DELETE  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Удаляет пользователя из указанного веб-ресурса.
insert POST  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Добавляет нового пользователя к указанному веб-ресурсу.
list GET  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks Выводит список ссылок на пользователей веб-ресурса для указанного веб-ресурса.
update PUT  /management/accounts/accountId/webproperties/webPropertyId/entityUserLinks/linkId Обновляет разрешения существующего пользователя для указанного веб-ресурса.