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

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

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

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

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

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

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

2023-10-05 Свойства с моделями атрибуции по первому клику, линейной, временной и позиционной атрибуции по умолчанию используют межканальный DDA.

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

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

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

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

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

01 сентября 2023 г. Добавлен метод UpdateConversionEvent .

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

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

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

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

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

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

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

Методы GetAdSenseLink , CreateAdSenseLink , DeleteAdSenseLink , ListAdSenseLinks добавлены в Admin API v1alpha.

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

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

Метод FetchConnectedGa4Property добавлен в Admin API v1alpha.

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

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

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

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

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

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

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

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

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

Методы properties.dataStreams.updateEnhancedMeasurementSettings , properties.dataStreams.getEnhancedMeasurementSettings добавлены в Admin API v1alpha.

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

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

Методы properties.createConnectedSiteTag , properties.deleteConnectedSiteTag , properties.listConnectedSiteTags добавлены в Admin API v1alpha.

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

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

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

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

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

2023-02-24 Привязки доступа заменяют пользовательские ссылки для управления разрешениями пользователей.

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

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

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

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

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

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

• accounts.userLinks.audit
• properties.userLinks.audit

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

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

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

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

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

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

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

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

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

15 февраля 2023 г. Добавлены методы управления ссылками Search Ads 360.

Ресурс SearchAds360Link был добавлен в альфа-версию API v1 вместе с соответствующими операциями 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 Различные изменения.

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

11 августа 2022 г. в Admin API v1alpha добавлен метод runAccessReport .

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

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

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

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

12 октября 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 поиск секретного протокола одного измерения.
  • 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 .

05.06.2021 Серьезные изменения.

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

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

28.01.2021 Добавлена ​​поддержка разбиения на страницы для операции ListFirebaseLinks .

28.01.2021 Серьезные изменения.

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

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

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

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

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

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

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

15.08.2020 API-интерфейс приложения и веб-интерфейса управления переименован в API администратора.

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