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

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

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

Добавлен метод GetReportingIdentitySettings в API администратора v1alpha, который позволяет получить ReportingIdentitySettings для свойства.

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

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

2025-06-12 Добавлены методы управления конфигурацией синхронизации подсвойств

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

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

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

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

2025-03-07 Отказ от параметра sharingWithGoogleAnySalesEnabled

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

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

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

2024-09-09 Форма опроса по отчетам о доступе

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

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

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

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

2024-08-01 Критическое изменение метода createSubproperty

Пользовательский метод createSubproperty переименован в provisionSubproperty в API администратора v1alpha для соответствия рекомендациям по пользовательским методам .

2024-08-01 Добавлено управление правилами редактирования событий

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

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

2024-08-01 Разные изменения

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

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

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

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

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

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

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

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

Более подробную информацию смотрите в документации по схеме .

2023-12-15 Измерение accessDateHour добавлено в схему отчета о доступе к данным.

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

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

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

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

2023-09-01 Добавлены методы конфигурации схемы значения конверсии SKAdNetwork.

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

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

2023-09-01 Добавлен метод UpdateConversionEvent .

Метод UpdateConversionEvent добавлен в API администратора v1beta.

2023-09-01 Поле BigQueryLink.enterprise_export_enabled переименовано в fresh_daily_export_enabled .

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

2023-07-14 Критические изменения в методах 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

2023-07-10 Добавлено поле ads_web_conversion_data_export_scope в тип AttributionSettings

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

05.06.2023 Прекращение поддержки моделей атрибуции по первому клику, линейной, по времени затухания и на основе позиции.

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

Более подробную информацию можно найти в объявлении о продукте Google Analytics .

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

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

2023-05-31 Добавлен метод поиска подключенного свойства GA4.

Метод FetchConnectedGa4Property добавлен в API администратора v1alpha

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

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

Методы CreateEventCreateRule , UpdateEventCreateRule , DeleteEventCreateRule , ListEventCreateRules , GetEventCreateRule добавлены в API администратора v1alpha.

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

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

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

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

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

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

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

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

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

Методы properties.createConnectedSiteTag , properties.deleteConnectedSiteTag , properties.listConnectedSiteTags добавлены в API администратора v1alpha.

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

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

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

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

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

Ресурс AccessBinding был добавлен в версию API v1alpha вместе со следующими операциями:

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

Функциональность пользовательских ссылок будет удалена из альфа-версии Admin API v1 01.06.23

2023-02-24 Прекращение поддержки методов аудита прав пользователей.

Следующие методы устарели и будут удалены из альфа-версии Admin API v1 01.06.23:

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

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

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

2023-02-15 Добавлены методы отказа от автоматизированного процесса настройки GA4.

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

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

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

2023-02-15 Критические изменения.

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

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

2023-02-15 Различные изменения.

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

2022-08-11 Метод runAccessReport добавлен в API администратора v1alpha.

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

2022-07-11 Выпущена версия Admin API v1beta.

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

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

2021-10-12 Методы 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.

2021-06-05 Добавлены функции.

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

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

2021-06-05 Критические изменения.

Были внесены следующие критические изменения:

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

2021-01-28 Критические изменения.

Критические изменения: - поле update_mask является обязательным для всех операций обновления.

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

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

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

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

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

2020-10-13 Свойства приложения и веб-сайта переименованы в Google Analytics 4 (GA4).

2020-08-15 Приложение для управления + веб-API переименовано в API администратора.

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