Для получения официальных объявлений об API Google Analytics подпишитесь на группу уведомлений Google Analytics API .
06.05.2024 Добавлены методы управления ключевыми событиями.
Теперь доступны ресурсы и методы для ключевых событий .
Измените интеграцию API, чтобы использовать KeyEvent
вместо ConversionEvent
. ConversionEvent
устарел.
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 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 года:
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 v1 . Он возвращает настроенный отчет о записях доступа к данным. В отчете представлены записи каждый раз, когда пользователь читает данные отчетов 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
добавлены методы управления секретами протокола измерений: - В разделе
properties.conversionEvents
добавлены методы управления событиями конверсии: - В разделе
properties.customDimensions
добавлены методы управления специальными измерениями: - В разделе
properties.customMetrics
добавлены методы управления пользовательскими метриками: - Добавлены методы
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 августа 2020 г. API приложения и веб-интерфейса управления переименованы в API администратора.
Google Analytics Management App + Web API был переименован в Google Analytics Admin API. В результате конечная точка API изменилась наanalyticsadmin.googleapis.com. Существующий код, написанный для предыдущей версии URL-адреса конечной точки API и клиентских библиотек, необходимо соответствующим образом обновить.