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

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

2024-09-09 Форма опроса Access Reports

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

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

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

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

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

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

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

GetEventEditRule , CreateEventEditRule , DeleteEventEditRule , ListEventEditRules , UpdateEventEditRules , ReorderEventEditRules — методы, добавленные в Admin API v1alpha.

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

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

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

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

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

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 сентября 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 .

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

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

Эта функция позволяет управлять разрешениями пользователей для учетной записи или ресурса 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.

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

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

Ресурс 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 добавлены методы управления секретами протокола измерений:
    • 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 Серьезные изменения.

Критические изменения: — Поле 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 и клиентских библиотек, необходимо соответствующим образом обновить.