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

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

14.04.2026 Добавлен метод GetUserProvidedDataSettings

2025-08-20 Добавлен метод GetReportingIdentitySettings

В версию 1alpha API администратора добавлен метод GetReportingIdentitySettings , позволяющий получить значения ReportingIdentitySettings для объекта недвижимости.

2025-08-20 Удалены устаревшие методы Universal Analytics

Из версии Admin API v1alpha были удалены следующие устаревшие методы Universal Analytics (UA): SetAutomatedGa4ConfigurationOptOut , FetchAutomatedGa4ConfigurationOptOut , CreateConnectedSiteTag , DeleteConnectedSiteTag , ListConnectedSiteTags и FetchConnectedGa4Property .

12.06.2025 Добавлены методы управления конфигурацией синхронизации подобъектов.

Добавлены методы GetSubpropertySyncConfig , ListSubpropertySyncConfig и UpdateSubpropertySyncConfig для управления ресурсами SubpropertySyncConfig с помощью Admin API v1alpha.

16.04.2025 Добавлены методы управления аннотированием данных для отчетности.

Добавлены методы CreateReportingDataAnnotation , GetReportingDataAnnotation , ListReportingDataAnnotations , UpdateReportingDataAnnotation и DeleteReportingDataAnnotation для управления ресурсами ReportingDataAnnotation с помощью Admin API v1alpha.

Функция аннотаций позволяет пользователям добавлять заметки непосредственно в отчеты Google Analytics, что упрощает запись событий, объяснение изменений в данных или выделение ключевых наблюдений для себя и своей команды.

07.03.2025 Параметр sharingWithGoogleAnySalesEnabled объявлен устаревшим

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

2025-01-20 Добавлена ​​опция сохранения пользовательских данных в DataRetentionSettings

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

09.09.2024 Форма опроса по отчетам о доступе

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

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

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

Добавлена ​​возможность внесения изменений в историю изменений с помощью ссылок BigQuery в поле ChangeHistoryResourceType со значением BIGQUERY_LINK .

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

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

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

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

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

01.08.2024 Различные изменения

Добавлена create_time в ресурс Audience .

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

Добавлена gmp_organization к ресурсу Account , которая содержит URI ресурса организации Google Marketing Platform, если учетная запись подключена к организации GMP.

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

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

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

15.12.2023 Отчеты о доступе к данным теперь доступны для всех ресурсов Google Analytics.

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

Для получения более подробной информации см. документацию по схеме .

15.12.2023 В схему отчета о доступе к данным добавлено измерение accessDateHour .

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

05.10.2023 Для объектов, использующих модели атрибуции по первому клику, линейной, временной и позиционной атрибуции, по умолчанию применяется кросс-канальный DDA.

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

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

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

В версию 1alpha API администратора добавлены методы GetSKAdNetworkConversionValueSchema , CreateSKAdNetworkConversionValueSchema , DeleteSKAdNetworkConversionValueSchema , UpdateSKAdNetworkConversionValueSchema , ListSKAdNetworkConversionValueSchemas .

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

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

В версию 1beta API администратора добавлен метод UpdateConversionEvent .

01.09.2023 Поле BigQueryLink.enterprise_export_enabled переименовано в fresh_daily_export_enabled .

Поле enterprise_export_enabled ресурса BigQueryLink переименовано в fresh_daily_export_enabled .

14.07.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.07.2023 Добавлено поле ads_web_conversion_data_export_scope в тип AttributionSettings

В тип AttributionSettings добавлено поле ads_web_conversion_data_export_scope , которое можно изменить с помощью метода UpdateAttributionSettings .

05.06.2023 Устаревание моделей атрибуции, основанных на первом клике, линейной атрибуции, атрибуции с временным затуханием и атрибуции на основе позиции.

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

Для получения более подробной информации обратитесь к анонсу продукта Google Analytics .

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

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

31.05.2023 Добавлен метод для поиска связанного свойства GA4.

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

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

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

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

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

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

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

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

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

31.03.2023 Добавлены расширенные методы управления настройками измерений.

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

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

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

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

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

31.03.2023 Добавлены методы runAccessReport на уровне учетной записи и свойства в Admin API v1beta.

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

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

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

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

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

Функция «Пользовательские ссылки» будет удалена из альфа-версии Admin API v1 1 июня 2023 года.

24.02.2023 Методы аудита прав доступа пользователей больше не используются.

Следующие методы устарели и будут удалены из альфа-версии Admin API 1 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.02.2023 Добавлены методы отказа от участия в автоматизированном процессе настройки GA4.

В версию v1alpha API добавлены операции properties.setAutomatedGa4ConfigurationOptOut и properties.fetchAutomatedGa4ConfigurationOptOut .

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

В версию v1alpha API добавлен ресурс BigQueryLink , а также соответствующие операции 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 и объектом Search Ads 360.

15.02.2023 Внесены существенные изменения.

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

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

15.02.2023 Различные изменения.

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

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

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

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

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

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

12.10.2021 Методы EnhancedMeasurementSettings удалены из API.

  • Методы 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 Analytics.

05.06.2021 Добавлены новые функции.

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

  • В API добавлен метод accounts.searchChangeHistoryEvents . Этот метод выполняет поиск по всем изменениям в учетной записи или ее дочерних элементах с учетом заданного набора фильтров. Типичными причинами могут быть обновления, внесенные в пользовательский интерфейс Google Analytics, изменения, внесенные службой поддержки, или автоматические изменения в системе Google Analytics.
  • Методы управления секретами протокола измерения добавлены в раздел properties.webDataStreams.measurementProtocolSecrets :
    • create Создает секрет протокола измерения.
    • delete Удаляет секретный ключ протокола измерения цели.
    • get секретный ключ протокола измерения в формате Lookup.
    • list секреты протокола измерения дочерних элементов, находящиеся в пределах указанного родительского свойства.
    • patch обновляет секретный ключ протокола измерения.
  • Методы управления событиями конверсии добавлены в раздел 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 Signals для ресурса Google Analytics 4.
  • К типу Property добавлены поля delete_time expire_time , предназначенные только для вывода.

05.06.2021 Внесены существенные изменения.

Были внесены следующие существенные изменения, нарушающие обратную совместимость:

  • Методы properties.iosAppDataStreams.create и properties.androidAppDataStreams.create были удалены из API. Пожалуйста, используйте Firebase для создания потоков данных приложения в свойстве Google Analytics 4.
  • Метод properties.delete теперь возвращает данные удаленного свойства в виде объекта типа Property , а не в виде пустого ответа.
  • Поле time_zone типа Property теперь является обязательным.
  • deleted поле удалено из типа Property .
  • Поле email_address типа UserLink теперь является неизменяемым.
  • Поле name типа UserLink теперь предназначено только для вывода.

28.01.2021 Внесены существенные изменения.

Изменения, нарушающие обратную совместимость: - Поле update_mask является обязательным для всех операций обновления.

  • Поле country_code переименовано в region_code в Account .

  • Поле url_query_parameter переименовано в uri_query_parameter в EnhancedMeasurementSettings .

  • parent поле удалено из GoogleAdsLink .

2020-10-20 Добавлена ​​поддержка сводных данных по счетам.

Добавлена ​​поддержка метода сводных данных по счетам .

13.10.2020 Приложение и веб-ресурсы переименованы в Google Analytics 4 (GA4).

15.08.2020 Приложение управления + веб-API переименованы в Admin API.

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