Обзор API администратора Google Analytics

Сводка : в этом документе представлен общий обзор API администратора Google Analytics версии 1.0.

В настоящее время этот API предоставляет функции, доступные в альфа- и бета-каналах.

Альфа

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

Бета

Критических изменений в этом канале не ожидается. Обратите внимание, что продукты до GA могут иметь ограниченную поддержку, а изменения в продуктах до GA могут быть несовместимы с другими версиями до GA.

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

Введение

API администратора Google Analytics обеспечивает программный доступ к данным конфигурации Google Analytics 4 (GA4) и совместим только с ресурсами GA4. Подробнее о свойствах GA4 …

Вы можете использовать API администратора Google Analytics, чтобы:

• Предоставление новых учетных записей.
• Управляйте аккаунтами.
• Управляйте настройками обмена данными.
• Список сводных данных по счетам.
• Поиск событий истории изменений.
• Управляйте свойствами.
• Подтвердите сбор пользовательских данных.
• Управляйте настройками хранения данных для ресурса.
• Управление настройками сигналов Google для ресурса (альфа-версия).
• Управляйте потоками.
• Управляйте секретами протокола измерений.
• Управление схемой ценности конверсии SKAdNetwork (альфа).
• Создайте фрагмент тега Google для потоков веб-данных (альфа-версия).
• Управляйте событиями-конверсиями.
• Управление специальными размерами.
• Управляйте пользовательскими метриками.
• Управляйте связями между ресурсами GA4 и проектами Firebase.
• Управляйте связями между ресурсами GA4 и аккаунтами Google Рекламы.
• Управляйте предложениями по установлению связи между ресурсом GA4 и рекламодателем Display & Video 360 (альфа).
• Управляйте связями между ресурсом GA4 и рекламодателем Display & Video 360 (альфа-версия).
• Управляйте связями между ресурсом GA4 и Search Ads 360 (альфа).
• Управляйте связями между ресурсом GA4 и проектом BigQuery (альфа-версия).
• Управляйте разрешениями пользователей для иерархии аккаунтов и свойств GA4 (альфа-версия).
• Создание отчетов о доступе к данным.
• Управление аудиторией (Альфа).
• Управление расширенными наборами данных (Альфа).
• Управляйте настройками отказа от автоматической настройки процесса установки GA4 (альфа-версия).

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

Вот доступные методы.

Предоставление учетной записи

• accounts.provisionAccountTicket

Этот метод возвращает поле accountTicketId , которое должно быть включено в URL-адрес условий обслуживания (TOS): https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID . Как только пользователь посетит URL-адрес TOS и примет Условия обслуживания, создание учетной записи Google Analytics будет завершено. См. пример подготовки учетной записи .

Управление счетами

• 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.acknowledgeUserDataCollection

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

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

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

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

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

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

Управление секретами протокола измерений

• 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.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.update

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

• 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

Предложения по связи между ресурсом GA4 и рекламодателем Display & Video 360 (альфа-версия)

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

Привязка аккаунтов рекламодателей Display & Video 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

Узнайте больше о настройке интеграции Analytics Search Ads 360 для ресурса GA4.

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

• properties.bigQueryLinks.get
• properties.bigQueryLinks.list

Узнайте больше о настройке экспорта BigQuery для ресурса GA4.

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

• 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 Analytics.

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

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

Узнайте больше о расширенных наборах данных в Google Analytics 360.

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

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

Узнайте больше об управлении статусом отказа в процессе автоматической настройки GA4 для ресурса UA.