Журнал изменений

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

18 июня 2026 г. Добавлен метод UpdateReportingIdentitySettings.

18 июня 2026 г. В тип PropertySummary добавлено поле can_edit.

  • В ресурс PropertySummary в Admin API v1alpha и v1beta добавлено поле can_edit. Это поле указывает, есть ли у пользователя роль Google Аналитики, которая позволяет ему изменять настройки ресурса.

14 апреля 2026 г. Добавлен метод GetUserProvidedDataSettings.

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, чтобы помочь нам его улучшить.

Добавлены методы 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 Аналитики.

В 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.

В версию v1alpha API добавлен ресурс AccessBinding и следующие операции:

Она позволяет управлять разрешениями пользователей для аккаунта или ресурса 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.

Ресурс BigQueryLink добавлен в версию API v1alpha вместе с соответствующими операциями properties.bigQueryLinks.get и properties.bigQueryLinks.list.

Эта функция позволяет получать информацию о связях между ресурсом GA4 и проектом BigQuery.

Ресурс 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 добавлены методы управления событиями-конверсиями:
    • create Создает событие-конверсию с указанными атрибутами.
    • delete Удаляет событие-конверсию в ресурсе.
    • get Получение одного события-конверсии.
    • list Возвращает список событий-конверсий в указанном родительском ресурсе.
  • В properties.customDimensions добавлены методы для управления специальными параметрами:
    • archive Архивирует специальный параметр в ресурсе.
    • create Создает специальный параметр.
    • get Поиск по одному специальному параметру.
    • list Возвращает список специальных параметров ресурса.
    • patch Обновляет специальный параметр в ресурсе.
  • В properties.customMetrics добавлены методы управления специальными показателями:
    • archive Отправляет в архив специальный показатель ресурса.
    • create Создает специальный показатель.
    • get Поиск одного специального показателя.
    • list Возвращает список специальных показателей ресурса.
    • patch Обновляет специальный показатель в ресурсе.
  • Добавлены методы 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 января 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 и клиентских библиотек, необходимо обновить соответствующим образом.