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

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

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 версии 1alpha добавлен метод GetReportingIdentitySettings, который позволяет получать ReportingIdentitySettings для ресурса.

20.08.2025 Удалены устаревшие методы Universal Analytics

Из Admin API версии 1alpha удалены следующие устаревшие методы 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 Аналитики, чтобы регистрировать события, объяснять изменения в данных и оставлять важную информацию для себя и коллег.

7 марта 2025 г. Прекращение поддержки параметра sharingWithGoogleAnySalesEnabled

Параметр sharingWithGoogleAnySalesEnabled метода getDataSharingSettings больше не поддерживается и всегда будет возвращать значение false. Это поле будет удалено из Google Analytics Admin API версии 1beta в июне 2025 г.

20.01.2025 Добавлены сведения о хранении пользовательских данных в DataRetentionSettings

В Admin API версий 1alpha и 1beta в DataRetentionSettings добавлено поле userDataRetention. Используйте это поле, чтобы получить или изменить настройки хранения пользовательских данных.

9 сентября 2024 г. Форма опроса о доступе к отчетам

Документация по методу runAccessReport была обновлена. Теперь в ней есть ссылка на форму обратной связи для отчетов о доступе к Google Аналитике. Мы ценим ваше мнение и призываем вас поделиться своими мыслями об этом API, чтобы помочь нам улучшить его.

Добавлены методы CreateBigQueryLink, UpdateBigQueryLink и DeleteBigQueryLink для управления ресурсами BigQueryLink с помощью Admin API версии 1alpha.

В ресурс BigQueryLink добавлено поле dataset_location.

В историю изменений добавлены сведения о том, как изменить связь с BigQuery, в новом значении BIGQUERY_LINK в ChangeHistoryResourceType.

01.08.2024. Критическое изменение метода createSubproperty

В Admin API версии 1alpha мы переименовали специальный метод createSubproperty в provisionSubproperty, чтобы он соответствовал рекомендациям по использованию специальных методов.

1 августа 2024 г. Добавлено управление правилами редактирования событий

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, методы, добавленные в Admin API версии 1alpha.

EventEditRule определяет условия, при которых будет создано совершенно новое событие на основе критериев исходного события. Кроме того, EventEditRule может определять изменения параметров исходного события.

1 августа 2024 г. Разные изменения

В ресурс Audience добавлено поле create_time.

В ресурс ChannelGroup добавлен параметр primary, который позволяет определить, является ли группа каналов группой по умолчанию для отчетов. Только одна группа каналов может иметь значение primary, равное true. Если для группы каналов задать значение true для параметра "Основная группа каналов" primary, то для предыдущей основной группы каналов автоматически будет задано значение false для параметра "Основная группа каналов" primary.

В ресурс Account добавлен параметр gmp_organization, который содержит URI ресурса организации Google Платформы для маркетинга, если аккаунт подключен к такой организации.

6 мая 2024 г. Добавлены методы управления ключевыми событиями

Теперь доступны ресурсы и методы для ключевых событий.

Измените интеграцию с API, чтобы использовать KeyEvent вместо ConversionEvent. ConversionEvent больше не поддерживается.

15 декабря 2023 г. Отчеты о доступе к данным теперь доступны для всех ресурсов Google Аналитики.

Некоторые поля функции Отчеты о доступе к данным теперь доступны для всех ресурсов Google Аналитики, как стандартных, так и Google Аналитики 360.

Дополнительную информацию можно найти в документации по схеме.

15 декабря 2023 г. В схему отчета о доступе к данным добавлен параметр accessDateHour.

Параметр accessDateHour, добавленный в схему отчета о доступе к данным. Содержит дату и время, когда пользователь Google Аналитики осуществил доступ к данным отчетов Google Аналитики.

5 октября 2023 г. Для ресурсов с моделями атрибуции по первому клику, линейной, с учетом давности взаимодействий и на основе позиции по умолчанию будет использоваться многоканальная атрибуция на основе данных.

С середины октября 2023 года модели атрибуции по первому клику, линейная, с учетом давности взаимодействий и на основе позиции нельзя будет использовать с методом UpdateAttributionSettings для всех ресурсов.

Если в вашем ресурсе используется одна из этих моделей, она будет заменена на многоканальную атрибуцию на основе данных. Вы по-прежнему сможете использовать многоканальную атрибуцию по последнему клику или последний клик в Google Рекламе.

01.09.2023 Добавлены методы настройки схемы ценности конверсий SKAdNetwork.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas методы, добавленные в Admin API v1alpha.

Эта функция позволяет управлять схемой ценности конверсий SKAdNetwork для потока данных iOS.

01.09.2023. Добавлен метод UpdateConversionEvent.

В Admin API v1beta добавлен метод UpdateConversionEvent.

2023-09-01 Поле 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 версии 1 alpha будут внесены критические изменения, которые повлияют на работу методов 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.

5 июня 2023 г. Прекращение поддержки моделей атрибуции по первому клику, линейной, с учетом давности взаимодействий и на основе позиции.

С июня 2023 года метод UpdateAttributionSettings нельзя использовать для настройки ресурсов GA4 с моделями атрибуции по первому клику, линейной, с учетом давности взаимодействий и на основе позиции. С сентября 2023 г. эти модели станут недоступны для всех ресурсов.

Подробнее о прекращении поддержки…

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks методы добавлены в Admin API версии 1alpha.

Эта функция позволяет управлять связями между AdSense и Аналитикой для ресурса GA4.

31 мая 2023 г. Добавлен метод для поиска связанного ресурса GA4.

В Admin API версии 1alpha добавлен метод FetchConnectedGa4Property

Эта функция позволяет получить информацию о ресурсе GA4, связанном с вашим ресурсом Universal Analytics, в процессе переноса данных в GA4.

31 мая 2023 г. Добавлен метод для управления правилами создания событий.

В Admin API версии 1 (альфа) добавлены методы CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules и GetEventCreateRule.

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

31 мая 2023 г. Добавлены методы для управления собственными группами каналов.

В Admin API версии 1alpha добавлены методы GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup и DeleteChannelGroup.

Эта функция позволяет управлять собственными группами каналов для источников трафика на вашем сайте.

После создания собственных групп каналов к ним можно отправлять запросы с помощью Google Analytics Data API v1.

31 марта 2023 г. Добавлены методы управления настройками улучшенной статистики.

Методы properties.dataStreams.updateEnhancedMeasurementSettings и properties.dataStreams.getEnhancedMeasurementSettings добавлены в Admin API версии 1alpha.

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

31 марта 2023 г. Добавлены методы управления подключенными тегами сайта.

В Admin API версии 1alpha добавлены методы properties.createConnectedSiteTag, properties.deleteConnectedSiteTag и properties.listConnectedSiteTags.

Эта функция позволяет управлять подключенными тегами сайта и перенаправлять трафик из ресурса Universal Analytics в ресурс Google Аналитики 4.

31 марта 2023 г. В Admin API версии 1beta добавлены методы runAccessReport на уровне аккаунта и ресурса.

В версию v1beta Admin API добавлены методы properties.runAccessReport и accounts.runAccessReport. Методы возвращают отчет о записях доступа к данным, созданный на основе заданных вами параметров.

24 февраля 2023 г. Добавлены методы управления расширенными наборами данных.

Ресурс ExpandedDataSet был добавлен в API версии v1alpha вместе с соответствующими операциями properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list и properties.expandedDataSets.get. Эту функцию можно использовать для управления расширенными наборами данных в Google Аналитике 360.

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

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

Функция "Связи с пользователями" будет удалена из Admin API версии 1 alpha 1 июня 2023 г.

24 февраля 2023 г. Прекращение поддержки методов аудита разрешений пользователей.

С 1 июня 2023 г. мы прекратим поддержку следующих методов и удалим их из Admin API версии 1 alpha:

24 февраля 2023 г. Добавлены методы управления аудиториями.

Ресурс Audience был добавлен в версию API v1alpha вместе с соответствующими операциями 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.

В версию v1alpha API добавлен ресурс BigQueryLink, а также соответствующие операции properties.bigQueryLinks.get и properties.bigQueryLinks.list.

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

Ресурс SearchAds360Link был добавлен в API версии v1alpha вместе с соответствующими операциями properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list и properties.searchAds360Links.get.

Эта функция позволяет управлять связями между ресурсом GA4 и объектом Поисковой рекламы 360.

15 февраля 2023 г. Критические изменения.

  • Значения LESS_THAN_OR_EQUAL и GREATER_THAN_OR_EQUAL удалены из перечисления NumericFilter.Operation.

  • Значение PARTIAL_REGEXP удалено из перечисления StringFilter.MatchType.

15 февраля 2023 г. Разные изменения.

  • В тип AccessQuota добавлено поле tokensPerProjectPerHour.
  • В перечисление ChangeHistoryResourceType добавлены значения EXPANDED_DATA_SET и CHANNEL_GROUP.
  • Значения searchAds360Link, expandedDataSet, bigqueryLink добавлены в ChangeHistoryResource.

11 августа 2022 г. В Admin API версии 1alpha добавлен метод runAccessReport.

В версию v1alpha Admin API добавлен метод properties.runAccessReport. Он возвращает настраиваемый отчет о записях доступа к данным. В отчете содержатся записи о каждом случае, когда пользователь просматривал данные отчетов Google Аналитики. Отчеты о доступе к данным доступны администраторам ресурсов Google Аналитики 360.

11 июля 2022 г. выпущена версия Admin API v1beta.

Выпущена бета-версия Google Analytics Admin API.

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

12 октября 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 Аналитике.

5 июня 2021 г. Добавлены функции.

В API добавлены следующие функции:

  • В API добавлен метод accounts.searchChangeHistoryEvents. Этот метод позволяет найти все изменения, внесенные в аккаунт или его дочерние элементы, с учетом заданных фильтров. Обычно это происходит из-за изменений, внесенных в интерфейсе Google Аналитики, службой поддержки или автоматически системой Google Аналитики.
  • В раздел properties.dataStreams.measurementProtocolSecrets добавлены методы управления секретными ключами Measurement Protocol:
    • create Создает секретный ключ Measurement Protocol.
    • delete Удаляет целевой секрет Measurement Protocol.
    • get Поиск одного секретного ключа Measurement Protocol.
    • list Возвращает секреты Measurement Protocol дочернего ресурса, указанного в родительском ресурсе.
    • 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.
  • delete_time, expire_time к типу Property добавлены поля, предназначенные только для вывода.

5 июня 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 октября 2020 г. Ресурсы типа "Приложение и сайт" переименованы в ресурсы Google Аналитики 4 (GA4).

15 августа 2020 г. Приложение и сайт Management App + Web API переименованы в Admin API.

Google Analytics Management App + Web API переименован в Google Analytics Admin API. В результате конечная точка API изменилась на analyticsadmin.googleapis.com. Существующий код, написанный для предыдущей версии URL конечной точки API и клиентских библиотек, необходимо обновить.