Обзор Google Analytics Admin API

Краткое описание. В этом документе представлен обзор Google Analytics Admin API версии 1.0.

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

Альфа-версия. Функции находятся на ранней стадии разработки. Мы стараемся уведомлять вас о предстоящих изменениях, но до публичного выпуска API могут произойти изменения, которые нарушат работу вашего кода.

Бета-версия: В этом канале не ожидается критических изменений.

Чтобы получать официальные объявления об API Google Аналитики, подпишитесь на группу уведомлений об API Google Аналитики.

Введение

Google Analytics Admin API позволяет получать программный доступ к данным конфигурации Google Аналитики и совместим только с ресурсами Google Аналитики. Подробнее о ресурсах Google Аналитики…

С помощью Google Analytics Admin API можно:

• Создавать новые аккаунты.
• Управление аккаунтами.
• Настройте доступ к данным.
• Получить список сводок по аккаунтам.
• Поиск событий в истории изменений.
• Управление ресурсами.
• Управлять дочерними ресурсами.
• Подтвердите, что вы собираете пользовательские данные.
• Как управлять настройками хранения данных для ресурса
• Управление настройками сигналов Google для ресурса (альфа-версия).
• Управление трансляциями.
• Как управлять секретными ключами Measurement Protocol
• Как управлять схемой ценности конверсий SKAdNetwork (альфа-версия)
• Как создать фрагмент тега Google для потоков данных сайта (альфа-версия)
• Управлять ключевыми событиями.
• Управление событиями-конверсиями (устаревшая функция).
• Как управлять правилами создания событий (альфа-версия)
• Как управлять правилами редактирования событий (альфа-версия)
• Как управлять специальными параметрами
• Управление специальными показателями.
• Управлять связями между ресурсами Google Аналитики и проектами Firebase.
• Управлять связью между ресурсами Google Аналитики и аккаунтами Google Рекламы.
• Управление предложениями для связи ресурса Google Аналитики с аккаунтом рекламодателя Дисплея и Видео 360 (альфа-версия)
• Управление связями между ресурсом Google Аналитики и аккаунтом рекламодателя Дисплея и Видео 360 (альфа-версия)
• Управление связями между ресурсом Google Аналитики и Поисковой рекламой 360 (альфа-версия)
• Управление связями между ресурсом Google Аналитики и проектом BigQuery (альфа-версия)
• Управление разрешениями пользователей для иерархии аккаунтов и ресурсов Google Аналитики (альфа-версия)
• Создавать отчеты о доступе к данным.
• Управление аудиториями (альфа-версия).
• Как управлять расширенными наборами данных (альфа-версия)
• Управление настройками отказа от автоматической настройки Google Аналитики (альфа-версия).

Доступные методы

Ниже перечислены доступные методы.

Подготовка аккаунта

• accounts.provisionAccountTicket

Этот метод возвращает поле accountTicketId, которое должно быть включено в URL страницы с условиями использования:

https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID

После того как пользователь перейдет по URL Условий использования и примет их, создание аккаунта Google Аналитики будет завершено. См. пример инициализации аккаунта.

Управление аккаунтами

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

Управление настройками доступа к данным

• accounts.getDataSharingSettings

Получение списка сводок по аккаунтам

• accountSummaries.list

Как искать события в истории изменений

• accounts.searchChangeHistoryEvents

Управление ресурсами

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

Управление дочерними ресурсами (альфа-версия)

• properties.provisionSubproperty

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

• properties.acknowledgeUserDataCollection

Управление настройками хранения данных

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

Управление настройками сигналов Google (альфа-версия)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

Управление потоками данных

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

Управление секретными ключами Measurement Protocol

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

Управление схемой ценности конверсий SKAdNetwork (альфа-версия)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

Управление ключевыми событиями

• properties.keyEvents.create
• properties.keyEvents.get
• properties.keyEvents.list
• properties.keyEvents.delete
• properties.keyEvents.patch

Управление событиями-конверсиями

Примечание. Вместо этого используйте ресурс KeyEvent и его методы.

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.patch

Управление правилами создания событий (альфа-версия)

• properties.dataStreams.eventCreateRules.create
• properties.dataStreams.eventCreateRules.get
• properties.dataStreams.eventCreateRules.list
• properties.dataStreams.eventCreateRules.delete
• properties.dataStreams.eventCreateRules.patch

Управление правилами редактирования событий (альфа)

• properties.dataStreams.eventEditRules.create
• properties.dataStreams.eventEditRules.get
• properties.dataStreams.eventEditRules.list
• properties.dataStreams.eventEditRules.delete
• properties.dataStreams.eventEditRules.patch
• properties.dataStreams.eventEditRules.reorder

Управление специальными параметрами

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

Управление специальными показателями

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

Связь с проектом Firebase

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

Связь с аккаунтом Google Рекламы

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

Создание тега Google (альфа-версия)

• properties.webDataStreams.getGlobalSiteTag

Запросы на установление связи между ресурсом Google Аналитики и рекламодателем Дисплея и Видео 360 (альфа-версия)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

Связывание аккаунтов рекламодателей в Дисплее и Видео 360 (альфа-версия)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

Связывание аккаунтов Поисковой рекламы 360 (альфа-версия)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

Подробнее о том, как настроить интеграцию Поисковой рекламы 360 с ресурсом Google Аналитики…

Связь с аккаунтом BigQuery (альфа-версия)

• properties.bigQueryLinks.create
• properties.bigQueryLinks.delete
• properties.bigQueryLinks.get
• properties.bigQueryLinks.list
• properties.bigQueryLinks.patch

Подробнее о том, как настроить экспорт в BigQuery для ресурса Google Аналитики…

Управление разрешениями пользователей (альфа-версия)

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

Отчеты о доступе к данным

• properties.runAccessReport

Подробнее об отчетах о доступе к данным…

Управление аудиториями (альфа-версия)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

Подробнее об аудиториях в Google Аналитике…

Управление расширенными наборами данных (альфа-версия)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

Подробнее о расширенных наборах данных в Google Аналитике 360…

Как отказаться от автоматической настройки Google Аналитики (альфа-версия)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

Подробнее об управлении статусом отказа от автоматической настройки Google Аналитики для ресурса UA…