Чтобы получать официальные объявления об API Google Аналитики, подпишитесь на группу Google Analytics API Notify.
18 июня 2026 г. Добавлен метод UpdateReportingIdentitySettings.
- В Admin API v1alpha добавлен метод
UpdateReportingIdentitySettings, который позволяет обновлятьReportingIdentitySettingsдля ресурса.
18 июня 2026 г. В тип PropertySummary добавлено поле can_edit.
- В ресурс
PropertySummaryв Admin API v1alpha и v1beta добавлено полеcan_edit. Это поле указывает, есть ли у пользователя роль Google Аналитики, которая позволяет ему изменять настройки ресурса.
14 апреля 2026 г. Добавлен метод GetUserProvidedDataSettings.
В Admin API v1alpha добавлен метод
GetUserProvidedDataSettings, который позволяет получатьUserProvidedDataSettingsдля ресурса.В Admin API версии 1alpha добавлен ресурс
UserProvidedDataSettings, который включает поляuserProvidedDataCollectionEnabledиautomaticallyDetectedDataCollectionEnabledдля сбора данных, предоставленных пользователями.
20.08.2025 Добавлен метод GetReportingIdentitySettings.
В Admin API v1alpha добавлен метод GetReportingIdentitySettings, который позволяет получать ReportingIdentitySettings для ресурса.
20.08.2025 Удалены устаревшие методы Universal Analytics.
Из Admin API v1alpha удалены следующие устаревшие методы Universal Analytics (UA): SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags и FetchConnectedGa4Property.
12 июня 2025 г. Добавлены методы управления конфигурацией синхронизации дочерних ресурсов.
Добавлены методы GetSubpropertySyncConfig, ListSubpropertySyncConfig и UpdateSubpropertySyncConfig для управления ресурсами SubpropertySyncConfig с помощью Admin API версии 1alpha.
16 апреля 2025 г. Добавлены методы управления аннотациями данных отчетов
Добавлены методы CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation и DeleteReportingDataAnnotation для управления ресурсами ReportingDataAnnotation с помощью Admin API версии 1alpha.
Заметки позволяют пользователям добавлять примечания непосредственно в отчеты Google Аналитики, чтобы регистрировать события, объяснять изменения в данных и оставлять важную информацию для себя и коллег.
07.03.2025 Прекращение поддержки параметра sharingWithGoogleAnySalesEnabled
Параметр sharingWithGoogleAnySalesEnabled метода getDataSharingSettings больше не поддерживается и всегда возвращает значение false. Поле будет удалено из Google Analytics Admin API v1beta в июне 2025 г.
20.01.2025 В DataRetentionSettings добавлена информация о хранении пользовательских данных.
В DataRetentionSettings в Admin API версий v1alpha и v1beta добавлено поле userDataRetention. Используйте это поле, чтобы получить или изменить настройки хранения пользовательских данных.
2024-09-09 Форма опроса об отчетах о доступе
В документацию по методу runAccessReport добавлена ссылка на форму Google Analytics Access Reports feedback (Отзывы об отчетах о доступе в Google Аналитике). Мы ценим ваше мнение и будем рады, если вы поделитесь своими мыслями об этом API, чтобы помочь нам его улучшить.
01.08.2024 Добавлено управление связями с BigQuery
Добавлены методы CreateBigQueryLink, UpdateBigQueryLink и DeleteBigQueryLink для управления ресурсами BigQueryLink с помощью Admin API версии 1alpha.
В ресурс BigQueryLink добавлено поле dataset_location.
В историю изменений добавлены изменения связи с BigQuery под новым значением BIGQUERY_LINK в ChangeHistoryResourceType.
01.08.2024. Критическое изменение в методе createSubproperty
Специальный метод createSubproperty переименован в provisionSubproperty в Admin API v1alpha в соответствии с рекомендациями по специальным методам.
01.08.2024 Добавлено управление правилами редактирования событий
В Admin API v1alpha добавлены методы GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules и ReorderEventEditRules.
EventEditRule определяет условия, которые вызовут создание совершенно нового события на основе критериев соответствия исходного события. Кроме того, EventEditRule может определять изменения параметров исходного события.
01.08.2024 Прочие изменения
В ресурс Audience добавлено поле create_time.
В ресурс ChannelGroup добавлено поле primary, которое указывает, является ли группа каналов группой по умолчанию для отчетов. Только у одной группы каналов может быть задано значение true для параметра primary. Если для группы каналов задать значение true для параметра primary, то для предыдущей основной группы каналов параметр primary автоматически получит значение false.
В ресурс Account добавлено поле gmp_organization, которое содержит URI ресурса организации Google Платформы для маркетинга, если аккаунт связан с такой организацией.
06.05.2024 Добавлены методы управления ключевыми событиями
Теперь доступны ресурсы и методы для ключевых событий.
Измените интеграцию с API, чтобы использовать KeyEvent вместо ConversionEvent.
ConversionEvent больше не поддерживается.
15 декабря 2023 г. Отчеты о доступе к данным теперь доступны для всех ресурсов Google Аналитики.
Некоторые поля отчетов о доступе к данным теперь доступны для всех ресурсов Google Аналитики, как стандартных, так и Google Аналитики 360.
Дополнительную информацию можно найти в документации по схеме.
15 декабря 2023 г. В схему отчета о доступе к данным добавлен параметр accessDateHour.
Параметр accessDateHour добавлен в схему отчета о доступе к данным. Оно содержит дату и час, когда пользователь Google Аналитики получил доступ к данным отчетов.
05.10.2023. В ресурсах, где использовались модели атрибуции по первому клику, линейная, с учетом давности взаимодействий и на основе позиции, по умолчанию будет использоваться многоканальная атрибуция на основе данных.
С середины октября 2023 года модели атрибуции по первому клику, линейная, с учетом давности взаимодействий и на основе позиции станут недоступны для использования с методом UpdateAttributionSettings для всех ресурсов.
Если в вашем ресурсе используется одна из этих моделей, она будет заменена на многоканальную атрибуцию на основе данных. Вы по-прежнему сможете использовать многоканальную атрибуцию по последнему клику или атрибуцию по последнему клику в Google Рекламе.
01.09.2023 Добавлены методы настройки схемы ценности конверсий SKAdNetwork.
В Admin API v1alpha добавлены методы GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema и ListSKAdNetworkConversionValueSchemas.
Эта функция позволяет управлять конфигурацией схемы ценности конверсий SKAdNetwork для потока iOS.
01.09.2023 Добавлен метод UpdateConversionEvent.
В Admin API v1beta добавлен метод UpdateConversionEvent.
01.09.2023 Поле BigQueryLink.enterprise_export_enabled переименовано в fresh_daily_export_enabled.
Поле enterprise_export_enabled ресурса BigQueryLink переименовано в fresh_daily_export_enabled.
14 июля 2023 г. Критические изменения в методах properties.updateAttributionSettings и properties.getAttributionSettings.
С 24 июля 2023 г. в альфа-версию Admin API v1 будут внесены критические изменения, которые повлияют на работу методов properties.getAttributionSettings и properties.updateAttributionSettings.
Элементы перечисления ReportingAttributionModel будут переименованы следующим образом:
| Прежнее название | Новое название |
|---|---|
CROSS_CHANNEL_DATA_DRIVEN |
PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN |
CROSS_CHANNEL_LAST_CLICK |
PAID_AND_ORGANIC_CHANNELS_LAST_CLICK |
CROSS_CHANNEL_FIRST_CLICK |
PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK |
CROSS_CHANNEL_LINEAR |
PAID_AND_ORGANIC_CHANNELS_LINEAR |
CROSS_CHANNEL_POSITION_BASED |
PAID_AND_ORGANIC_CHANNELS_POSITION_BASED |
CROSS_CHANNEL_TIME_DECAY |
PAID_AND_ORGANIC_CHANNELS_TIME_DECAY |
ADS_PREFERRED_LAST_CLICK |
GOOGLE_PAID_CHANNELS_LAST_CLICK |
Элементы перечисления AdsWebConversionDataExportScope будут переименованы следующим образом:
| Прежнее название | Новое название |
|---|---|
CROSS_CHANNEL |
PAID_AND_ORGANIC_CHANNELS |
ADS_PREFERRED |
GOOGLE_PAID_CHANNELS |
10 июля 2023 г. В тип AttributionSettings добавлено поле ads_web_conversion_data_export_scope.
В тип AttributionSettings добавлено поле ads_web_conversion_data_export_scope, которое можно изменить с помощью метода UpdateAttributionSettings.
05.06.2023. Прекращение поддержки моделей атрибуции по первому клику, линейной, с учетом давности взаимодействий и на основе позиции.
С июня 2023 года метод UpdateAttributionSettings нельзя использовать для настройки ресурсов GA4 с моделями атрибуции по первому клику, линейной, с учетом давности взаимодействий и на основе позиции. С сентября 2023 года эти модели станут недоступны для всех ресурсов.
Дополнительную информацию можно найти в анонсе Google Аналитики.
31 мая 2023 г. Добавлены методы управления связями с AdSense.
В Admin API v1alpha добавлены методы GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink и ListAdSenseLinks.
Эта функция позволяет управлять связями между AdSense и Аналитикой для ресурса GA4.
31 мая 2023 г. Добавлен метод для поиска подключенного ресурса GA4.
В Admin API версии 1alpha добавлен метод FetchConnectedGa4Property.
Эта функция позволяет получать информацию о ресурсе GA4, связанном с вашим ресурсом Universal Analytics, во время перехода на GA4.
31 мая 2023 г. Добавлен метод для управления правилами создания событий.
В Admin API v1alpha добавлены методы CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules и GetEventCreateRule.
Эта функция позволяет управлять правилами создания событий, которые могут инициировать создание совершенно нового события на основе критериев соответствия исходного события.
31.05.2023 Добавлены методы для управления собственными группами каналов.
В Admin API v1alpha добавлены методы GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup и DeleteChannelGroup.
Эта функция позволяет управлять собственными группами каналов для источников трафика на вашем сайте.
После создания собственных групп каналов к ним можно отправлять запросы с помощью Google Analytics Data API v1.
31.03.2023 Добавлены методы управления настройками улучшенной статистики.
properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings. Методы добавлены в Admin API версии 1alpha.
Эта функция позволяет управлять настройками улучшенной статистики для потока данных сайта в ресурсе GA4.
31 марта 2023 г. Добавлены методы управления подключенными тегами сайта.
В Admin API v1alpha добавлены методы properties.createConnectedSiteTag, properties.deleteConnectedSiteTag и properties.listConnectedSiteTags.
Эта функция позволяет управлять подключенными тегами сайта и полезна для перенаправления трафика из ресурса Universal Analytics в ресурс Google Аналитики 4.
31 марта 2023 г. В Admin API v1beta добавлены методы runAccessReport на уровне аккаунта и ресурса.
В версию v1beta Admin API добавлены методы properties.runAccessReport и accounts.runAccessReport. Методы возвращают отчет о записях доступа к данным, созданный на основе заданных вами параметров.
24.02.2023. Добавлены методы управления расширенными наборами данных.
Ресурс ExpandedDataSet добавлен в версию v1alpha API вместе с соответствующими операциями properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list и properties.expandedDataSets.get. Эта функция позволяет управлять расширенными наборами данных в Google Аналитике 360.
24.02.2023. Для управления разрешениями пользователей вместо ссылок на пользователей теперь используются привязки доступа.
В версию v1alpha API добавлен ресурс AccessBinding и следующие операции:
accounts.accessBindings.createaccounts.accessBindings.deleteaccounts.accessBindings.patchaccounts.accessBindings.listaccounts.accessBindings.getaccounts.accessBindings.batchCreateaccounts.accessBindings.batchDeleteaccounts.accessBindings.batchUpdateaccounts.accessBindings.batchGetproperties.accessBindings.createproperties.accessBindings.deleteproperties.accessBindings.patchproperties.accessBindings.listproperties.accessBindings.getproperties.accessBindings.batchCreateproperties.accessBindings.batchDeleteproperties.accessBindings.batchUpdateproperties.accessBindings.batchGet
Она позволяет управлять разрешениями пользователей для аккаунта или ресурса GA4 и должна использоваться вместо User Links.
Функция User Links будет удалена из Admin API v1 alpha 1 июня 2023 г.
24 февраля 2023 г. Прекращение поддержки методов аудита разрешений пользователей.
Следующие методы устарели и будут удалены из Admin API версии 1 alpha 1 июня 2023 г.:
24.02.2023. Добавлены методы управления аудиториями.
Ресурс Audience добавлен в версию v1alpha API вместе с соответствующими операциями properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list и properties.audience.get.
Эта функция позволяет управлять аудиториями для ресурса GA4.
15 февраля 2023 г. Добавлены способы отказа от автоматической настройки GA4.
В версию v1alpha API добавлены операции properties.setAutomatedGa4ConfigurationOptOut и properties.fetchAutomatedGa4ConfigurationOptOut.
Эта функция позволяет управлять статусом отказа от автоматической настройки GA4 для ресурса UA.
15 февраля 2023 г. Добавлены методы управления связями с BigQuery.
Ресурс BigQueryLink добавлен в версию API v1alpha вместе с соответствующими операциями properties.bigQueryLinks.get и properties.bigQueryLinks.list.
Эта функция позволяет получать информацию о связях между ресурсом GA4 и проектом BigQuery.
15 февраля 2023 г. Добавлены методы управления связями с Поисковой рекламой 360.
Ресурс SearchAds360Link добавлен в версию v1alpha API вместе с соответствующими операциями properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list и properties.searchAds360Links.get.
Эта функция позволяет управлять связями между ресурсом GA4 и объектом Поисковой рекламы 360.
15 февраля 2023 г. Критические изменения.
Из перечисления
NumericFilter.Operationудалены значенияLESS_THAN_OR_EQUALиGREATER_THAN_OR_EQUAL.Из перечисления
StringFilter.MatchTypeудалено значениеPARTIAL_REGEXP.
15 февраля 2023 г. Различные изменения.
- Поле
tokensPerProjectPerHourдобавлено в типAccessQuota. - В перечисление
ChangeHistoryResourceTypeдобавлены значенияEXPANDED_DATA_SETиCHANNEL_GROUP. - Значения
searchAds360Link,expandedDataSet,bigqueryLinkдобавлены вChangeHistoryResource.
11 августа 2022 г. В Admin API v1alpha добавлен метод runAccessReport.
В версию v1alpha Admin API добавлен метод properties.runAccessReport. Вы получите специальный отчет с записями о доступе к данным. В отчете регистрируется каждый случай, когда пользователь просматривает данные отчетов Google Аналитики. Отчеты о доступе к данным доступны администраторам ресурсов Google Аналитики 360.
11 июля 2022 г. Выпущена бета-версия Admin API v1.
Выпущена бета-версия Google Analytics Admin API.
Для Admin API по-прежнему поддерживаются альфа- и бета-каналы. Бета-канал содержит подмножество функций, доступных в альфа-канале, которые считаются стабильными и не будут значительно изменены в будущем. Новые функции будут добавляться в бета-версию по мере их готовности.
12.10.2021. Из API удалены методы EnhancedMeasurementSettings.
- Методы
properties.webDataStreams.getEnhancedMeasurementSettingsиproperties.webDataStreams.updateEnhancedMeasurementSettingsудалены из API, но скоро настройки улучшенной статистики снова можно будет изменять через API. - Поле
directRolesресурсаUserLinkбольше не поддерживает рольpredefinedRoles/manage-users. Вместо них следует использовать новую рольpredefinedRoles/admin, которая эквивалентна сочетанию старых ролейpredefinedRoles/editиpredefinedRoles/manage-users. Это изменение влияет на работу методовaccounts.userLinksиproperties.userLinksи соответствует изменениям в управлении доступом и ограничениями в отношении данных, которые были внесены в Google Аналитику.
05.06.2021 Добавлены функции.
В API добавлены следующие функции:
- В API добавлен метод
accounts.searchChangeHistoryEvents. Этот метод выполняет поиск по всем изменениям в аккаунте или его дочерних аккаунтах с учетом заданного набора фильтров. Распространенные причины – обновления, внесенные в интерфейсе Google Аналитики, изменения, выполненные службой поддержки, или автоматические изменения в системе Google Аналитики. - В
properties.dataStreams.measurementProtocolSecretsдобавлены методы управления секретными ключами Measurement Protocol:createСоздает секретный ключ Measurement Protocol.deleteУдаляет секретный ключ Measurement Protocol.getПоиск одного секретного ключа Measurement Protocol.listВозвращает секретные ключи дочерних ресурсов, связанных с указанным родительским ресурсом.patchОбновляет секретный ключ Measurement Protocol.
- В
properties.conversionEventsдобавлены методы управления событиями-конверсиями: - В
properties.customDimensionsдобавлены методы для управления специальными параметрами: - В
properties.customMetricsдобавлены методы управления специальными показателями: - Добавлены методы
properties.getGoogleSignalsSettingsиproperties.updateGoogleSignalsSettings, позволяющие управлять настройкой сигналов Google для ресурса Google Аналитики 4. - В тип
Propertyдобавлены поля, предназначенные только для вывода:delete_timeиexpire_time.
05.06.2021. Критические изменения.
Были внесены следующие критические изменения:
- Методы
properties.iosAppDataStreams.createиproperties.androidAppDataStreams.createудалены из API. Чтобы создать потоки данных приложений в ресурсе Google Аналитики 4, используйте Firebase. - Метод
properties.deleteтеперь возвращает данные удаленного ресурса как типProperty, а не пустой ответ. - Поле
time_zoneтипаPropertyтеперь является обязательным. - Поле
deletedудалено из типаProperty. - Поле
email_addressтипаUserLinkтеперь неизменяемое. - Поле
nameтипаUserLinkтеперь используется только для вывода.
28.01.2021. Добавлена поддержка разбивки на страницы для операции ListFirebaseLinks.
28 января 2021 г. Критические изменения.
Критические изменения:
- Поле update_mask теперь обязательно для всех операций обновления.
Поле
country_codeпереименовано вregion_codeвAccount.Поле
url_query_parameterпереименовано вuri_query_parameterвEnhancedMeasurementSettings.Поле "
parent" удалено из таблицы "GoogleAdsLink".
20.10.2020 Добавлена поддержка сводок аккаунтов.
Добавлена поддержка метода account summaries.
13.10.2020. Ресурсы типа "Приложение и сайт" переименованы в "Google Аналитика 4" (GA4).
15.08.2020. Management App + Web API переименован в Admin API.
Google Analytics Management App + Web API переименован в Google Analytics Admin API. В результате конечная точка API изменилась на analyticsadmin.googleapis.com. Существующий код, написанный для предыдущей версии URL конечной точки API и клиентских библиотек, необходимо обновить соответствующим образом.