Мы периодически обновляем API управления Google Analytics, чтобы предоставлять новые функции и устранять дефекты, обнаруженные в предыдущих версиях. В большинстве случаев эти изменения будут прозрачны для разработчиков API. Однако иногда нам необходимо внести изменения, которые требуют от разработчиков модификации существующих приложений.
На этой странице документируются любые изменения, внесенные в API управления Google Analytics, которые могут повлиять на ваше приложение. Мы рекомендуем разработчикам API периодически проверять этот список на наличие новых объявлений. Вы также можете подписаться на изменения через каналы, перечисленные в разделе «Подписка» ниже.
Подпишитесь на соответствующие журналы изменений
Включает все API сбора, настройки и отчетности.
Включает API управления и API обеспечения.
Выпуск 17 июля 2018 г. (17 июля 2018 г.)
Метод hashClientId добавлен в Management API.
Метод hashClientId предоставляет хеш данного идентификатора клиента, который можно найти в определенных форматах экспортируемых данных, например в данных Google Analytics, экспортированных в BigQuery .
Выпуск от 11 мая 2018 г. (11 мая 2018 г.)
Настройки хранения пользовательских данных в Management API
Теперь можно программно настроить параметры хранения пользовательских данных, используя новые поля dataRetentionTtl и dataRetentionResetOnNewActivity, добавленные в ресурс WebProperty .
Выпуск от 22 февраля 2018 г. (22 февраля 2018 г.)
Операции записи в Management API
Операции записи в Management API (например, создание, обновление, удаление, исправление) для ресурсов веб-ресурса, представления (профиля) и цели больше не требуют внесения в белый список. Дневной лимит по умолчанию для всех операций записи в Management API составляет 50 операций записи в день. Дополнительную информацию см. на странице «Лимиты и квоты» .
Выпуск от 19 апреля 2017 г. (19 апреля 2017 г.)
Аудитория ремаркетинга – поддержка оптимизации
В этом выпуске добавлена поддержка Google Optimize и OPTIMIZE
в качестве типа связанного рекламного аккаунта. Подробную информацию см. в справочной документации по Аудитории ремаркетинга и в руководстве разработчика по Аудитории ремаркетинга .
Выпуск 23 марта 2017 г. (23 марта 2017 г.)
Аудитория ремаркетинга
В этом выпуске к ресурсу «Аудитория ремаркетинга» добавлена команда DELETE
. Подробную информацию см. в руководстве для разработчиков «Аудитории ремаркетинга» .
- Аудитория ремаркетинга: удалить — удаляет аудиторию ремаркетинга.
Выпуск от 09 февраля 2017 г. (9 февраля 2017 г.)
Пользовательские метрики
Это выпуск с исправлением ошибок; он устраняет проблему, из-за которой не удавалось создать специальную метрику типа TIME
, если min_value
не было установлено. Запросы без min_value
теперь создают пользовательскую метрику с min_value
по умолчанию, равным 0 .
Выпуск от 09 августа 2016 г. (9 августа 2016 г.)
Валюты
Это выпуск с исправлением ошибок; исправлена проблема, из-за которой подмножество валют поддерживалось в веб-интерфейсе Analytics, но не поддерживалось в API . В этом выпуске добавлена поддержка следующих валют:
- UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL
Для получения дополнительной информации см.: - Справочник по представлениям (профилям) . – Статья Справочного центра «Справочник валют» .
Выпуск 8 августа 2016 г. (8 августа 2016 г.)
В этом выпуске в Management API добавлены аудитории ремаркетинга.
Аудитории ремаркетинга
API управления позволяет create
, get
, list
, update
и patch
аудитории ремаркетинга для ресурса Google Analytics. Дополнительную информацию о том, как работают аудитории ремаркетинга, можно найти в статье Справочного центра «Об аудиториях ремаркетинга в Analytics» .
Выпуск от 11 марта 2016 г. (11 марта 2016 г.)
В главной роли
В этом выпуске свойство starred
добавлено в разделы «Сводки учетных записей» , «Учетные записи» , «Веб-свойства» и «Представления (профили)» .
Выпуск 25 февраля 2016 г. (25 февраля 2016 г.)
Ограничение частоты ошибок
Наша политика всегда заключалась в том, что разработчики должны реализовывать экспоненциальную задержку при обработке ответов 500 или 503 . Сегодня мы вводим ограничение на количество ошибок 500 и 503, чтобы обеспечить соблюдение этой политики.
- 50 неудачных запросов на запись в час.
Выпуск от 01 февраля 2016 г. (1 февраля 2016 г.)
Полные отчеты
API полных отчетов больше не имеет ограничения в 100 отчетов в день. В API используется та же система токенов по каждому ресурсу и за день, что и при создании полного отчета через веб-интерфейс.
Выпуск 26 января 2016 г. (26 января 2016 г.)
Полные отчеты
Полные отчеты, недоступные текущему пользователю, больше не будут иметь ссылку для скачивания в ответном сообщении Management API. Такое поведение теперь соответствует функциональности информационной панели пользовательского интерфейса, где только владельцы отчетов могут видеть ссылку для скачивания созданного документа.
Выпуск 17 декабря 2015 г. (17 декабря 2015 г.)
Просмотры (профили)
В этом выпуске к ресурсу представления (профиля) добавлено свойство botFilteringEnabled
. Это свойство указывает, включена ли фильтрация ботов для представления (профиля). Подробности см. в справочной документации по представлениям (профилям) .
Полные отчеты
В этом выпуске к полным отчетам добавлен метод delete
. Подробности см. в справочной документации по удалению полных отчетов .
Выпуск от 17 ноября 2015 г. (17 ноября 2015 г.)
Сегменты
Это релиз с исправлением ошибок. В этом выпуске исправлена проблема, из-за которой сегменты со значениями валют в определении отображались неправильно при вызове метода списка сегментов .
Выпуск от 06 октября 2015 г. (6 октября 2015 г.)
Сегменты
Это релиз с исправлением ошибок. В этом выпуске исправлена проблема, из-за которой пользователи с частными сегментами, закрепленными за несколькими представлениями (профилями), получали ответ об ошибке 500
при вызове метода списка сегментов .
Выпуск от 03 сентября 2015 г. (3 сентября 2015 г.)
Пакетирование
В этом выпуске, помимо общей поддержки пакетной обработки , мы добавили специальную поддержку User Permissions API . Пакетные запросы разрешений пользователей позволят значительно повысить производительность и сократить использование квот.
Выпуск от 06 августа 2015 г. (6 августа 2015 г.)
Просмотры (профили)
В этом выпуске свойство currency
представления (профиля) по умолчанию будет установлено в долларах США , если оно не было установлено во время операции вставки . Также операции get
и list
будут возвращать доллары США для представлений (профилей), которые ранее были созданы без свойства currency
.
Подробную информацию об использовании представления (профилей) в Management API см. в руководстве разработчика представления (профиля).
Полный список параметров ресурса «Представление (профиль)» см. в справочнике « Представление (профили)».
Выпуск 28 мая 2015 г. (28 мая 2015 г.)
Фильтры
В этом выпуске окончательно удаляются устаревшие поля фильтра IS_MOBILE
и IS_TABLET
, которые следует заменить на DEVICE_CATEGORY=mobile
и DEVICE_CATEGORY=tablet
. Запросы на вставку, обновление и исправление, которые устанавливают в полях фильтра использование IS_MOBILE
и IS_TABLET
вернут ошибку.
Подробную информацию об использовании фильтров в Management API см. в руководстве разработчика фильтров .
Полный список параметров ресурса фильтра см. в справочнике по фильтрам .
Выпуск от 05 мая 2015 г. (5 мая 2015 г.)
Фильтры
В этом выпуске добавлена поддержка использования специального измерения для поля фильтра путем добавления свойства fieldIndex
во все разделы сведений о фильтре. Например, теперь можно установить выражение фильтра с помощью "field": "CUSTOM_DIMENSION"
и "fieldIndex": "1"
чтобы фильтр работал по первому пользовательскому измерению.
Подробную информацию об использовании фильтров в Management API см. в руководстве разработчика фильтров .
Полный список параметров ресурса фильтра см. в справочнике по фильтрам .
Цели
В этом выпуске также исправлена проблема, из-за которой создание цели со "comparisonValue": "0"
не удавалось.
Подробную информацию об использовании целей в Management API см. в руководстве разработчика целей .
Полный список параметров ресурса «Цель» см. в справочнике по целям .
Выпуск от 13 марта 2015 г. (13 марта 2015 г.)
Этот выпуск знаменует собой окончательное отключение и удаление ресурса dailyUpload
. Ресурс dailyUpload
был официально признан устаревшим 20 июня 2014 г.; весь импорт данных о расходах теперь должен выполняться с использованием ресурса загрузки .
- Дополнительную информацию о процессе прекращения поддержки Google Analytics API см. в Политике прекращения поддержки данных .
- Подробную информацию о том, как импортировать данные в Google Analytics, см. в Руководстве разработчика по импорту данных .
Выпуск 23 января 2015 г. (23 января 2015 г.)
В этом выпуске в Management API добавлены две новые коллекции: специальные измерения и специальные показатели.
Специальные параметры и показатели
Теперь можно создавать, перечислять, получать, исправлять и обновлять специальные параметры и показатели с помощью Management API.
Выпуск 8 января 2015 г. (8 января 2015 г.)
Ответ метода list
для всех коллекций теперь включает пустой список для свойства items
, если коллекция не содержит ресурсов. Раньше свойство items
в ответе опускалось. См. Справочник по API для получения полной информации о запросах и ответах на данные конфигурации Google Analytics.
Выпуск 16 декабря 2014 г. (16 декабря 2014 г.)
Исправление ошибок
- Исправление ошибки 467 — коллекция сегментов теперь возвращает сегменты, использующие синтаксис
dateOfSession
.
Выпуск 20 ноября 2014 г. (20 ноября 2014 г.)
В этом выпуске представлена новая область применения API управления Google Analytics . analytics.manage.users.readonly
— просмотр разрешений пользователей Google Analytics.
Выпуск от 05 ноября 2014 г. (5 ноября 2014 г.)
Было добавлено новое поле фильтров DEVICE_CATEGORY
, а IS_MOBILE
и IS_TABLET
больше не поддерживаются. Используйте DEVICE_CATEGORY=mobile
и DEVICE_CATEGORY=tablet
.
Выпуск 29 октября 2014 г. (29 октября 2014 г.)
Ресурс View (Profile) теперь включает свойство enhancedECommerceTracking
, которое указывает, включена ли расширенная электронная торговля ( true
) или отключена ( false
).
Выпуск 2014-06 (20 июня 2014 г.)
Этот выпуск включает новые типы импорта данных и прекращение поддержки ресурса dailyUpload
.
Импорт данных
Подробную информацию о том, как использовать Management API для импорта данных в вашу учетную запись Google Analytics, см. в Руководстве разработчика по импорту данных .
Загрузки
- Ресурс
upload
теперь поддерживает следующие типы загрузки:- Данные кампании
- Данные контента
- Данные о затратах
- Данные продукта
- Данные о возврате
- Данные пользователя
- Ресурс
upload
имеет новыйmigrateDataImport
для переноса существующих данных о затратахcustomDataSources
.
Прекращение поддержки ежедневных загрузок
- Ресурс
dailyUpload
устарел! дополнительные сведения о переходе с использованием функции импорта данных см. в Руководстве по миграции . - Ресурс
dailyUpload
будет продолжать работать еще шесть месяцев, после чего все оставшиесяcustomDataSources
со свойствомuploadType
, имеющим значениеanalytics#dailyUploads
будут автоматически перенесены и работать только с ресурсомupload
. - Текущим пользователям ресурса
dailyUpload
следует обновить свой код и перейти на использование ресурса Upload как можно скорее.
Выпуск 2014-05 (28 мая 2014 г.)
В этом выпуске добавлены два новых API конфигурации.
Ссылки AdWords
Ссылки AdWords в Management API позволяют создавать, перечислять, получать, обновлять, исправлять и удалять связи между учетными записями Google AdWords и ресурсами Google Analytics, а также управлять тем, какие представления (профили) связаны с данными AdWords.
Фильтры
Фильтры в Management API позволяют создавать, перечислять, получать, обновлять, исправлять и удалять фильтры для вашей учетной записи Google Analytics. Ссылки на фильтры профилей позволяют создавать, перечислять, получать, обновлять, исправлять и удалять связи между фильтрами и представлениями (профилями).
Выпуск 27 мая 2014 г. (27 мая 2014 г.)
Полные отчеты: API управления
В Management API добавляется новый ресурс под названием Unsampled Reports . Полные отчеты – это отчеты Google Analytics (GA), созданные с использованием полных данных. Полные отчеты в настоящее время доступны только пользователям GA Premium.
Выпуск от 11 апреля 2014 г. (11 апреля 2014 г.)
Сегменты: Management API v2.4 и v3.0
В коллекцию сегментов были внесены следующие изменения:
- В API теперь поддерживаются сегменты пользователей и последовательностей.
- Коллекция сегментов теперь возвращает все встроенные и настраиваемые сегменты уровня сеанса и пользователя .
- Свойство
definition
сегментов теперь будет использовать новый синтаксис сегментов. Сюда входят определения для существующих сегментов уровня сеанса , которые изменятся по сравнению сdefinition: " "
definition: " "
definition: "sessions::condition:: "
definition: "sessions::condition:: "
- К ресурсу Segment было добавлено новое свойство
type
, указывающее, является ли сегментCUSTOM
(т. е. создан пользователем в веб-интерфейсе) илиBUILT_IN
(т. е. предоставлен Google Analytics).
Эксперименты
Следующие показатели AdSense теперь можно использовать в качестве целей оптимизации:
-
ga:adsenseAdsClicks
— количество кликов по объявлениям AdSense на вашем сайте. -
ga:adsenseAdsViewed
— количество просмотренных объявлений AdSense. В одном рекламном блоке может отображаться несколько объявлений. -
ga:adsenseRevenue
— общий доход от рекламы AdSense.
Выпуск 25 марта 2014 г. (25 марта 2014 г.)
Новая коллекция сводок по счетам
- Коллекция AccountSummaries добавлена в Management API. Он предоставляет сводную информацию для каждой учетной записи, ресурса и представления (профиля), к которым авторизованный пользователь имеет доступ, в одном и быстром запросе. Подробности см. в Руководстве разработчика по сводкам учетных записей .
Выпуск от 12 декабря 2013 г. (12 декабря 2013 г.)
Следующие изменения были внесены в сегменты по умолчанию в связи с прекращением поддержки измерений ga:isMobile
и ga:isTablet
:
- Сегмент
gaid::-11
переименован из «Мобильный трафик» в «Мобильный и планшетный трафик» . Определение этого сегмента было изменено сga:isMobile==Yes
наga:deviceCategory==mobile,ga:deviceCategory==tablet
. Обратите внимание, чтоga:isMobile
учитывает трафик планшетов, что отражено в новом определении. Если вам нужен только мобильный трафик, исключая планшеты, переключитесь на новый сегмент «Мобильный трафик» (gaid::-14
). - Определение сегмента
gaid::-13
изменено сga:isTablet==Yes
наga:deviceCategory==tablet
. Это по-прежнему представляет собой трафик планшетов . - Добавлен сегмент
gaid::-14
. Имя сегмента — «Мобильный трафик» , а определение —ga:deviceCategory==mobile
.
Выпуск 28 октября 2013 г. (28 октября 2013 г.)
Исправление ошибок:
- Исправлена информация о часовом поясе для представлений (профилей). Подробности : до этого исправления в некоторых случаях при перечислении представлений (профилей) в Management API возвращалась неверная информация о часовом поясе для представления (профиля). Теперь информация о часовом поясе для представлений (профилей) соответствует тому, что установлено в интерфейсе администратора Google Analytics.
Выпуск от 04 октября 2013 г. (4 октября 2013 г.)
Загрузки (расширение измерения)
- Новый ресурс «Загрузки» позволяет загружать данные расширения параметров. Подробности см. в Руководстве разработчика по импорту (загрузке) данных .
Выпуск от 03 октября 2013 г. (3 октября 2013 г.)
В этом выпуске представлены операции записи для ресурсов веб-ресурса, представления (профиля) и цели, а также набор из трех новых ресурсов, которые позволяют управлять разрешениями пользователей.
API настройки и настройки учетной записи
- Представления (профили) теперь можно создавать, обновлять, исправлять и удалять. Подробные сведения о новых методах см. в справочнике по представлениям (профилям) .
- Веб-свойства и цели теперь можно создавать, обновлять и исправлять. Подробные сведения о новых методах см. в справочнике по веб-свойствам и справочнике по целям .
- Теперь с помощью метода
get
можно запросить отдельный веб-ресурс, представление (профиль) или цель. - Эти функции в настоящее время доступны в виде предварительной версии для разработчиков в рамках ограниченной бета-версии. Если вы заинтересованы в регистрации, запросите доступ к бета-версии .
Разрешения пользователя в Management API
- Новый ресурс accountUserLinks позволяет управлять разрешениями учетной записи пользователей.
- Новый ресурс webpropertyUserLinks позволяет управлять разрешениями на свойства для пользователей.
- Новый ресурс ProfileUserLinks позволяет управлять разрешениями просмотра (профиля) для пользователей.
- Разрешения для авторизованного пользователя теперь доступны как часть ресурсов «Учетная запись» , «Веб-ресурс» и «Просмотр (Профиль)» .
- Была введена новая область, которая необходима для управления разрешениями пользователей.
https://www.googleapis.com/auth/analytics.manage.users
. - Дополнительные сведения см . в Руководстве разработчиков по разрешениям пользователей .
Выпуск 15 июля 2013 г. (16 июля 2013 г.)
В рамках запуска новых сегментов мы внесем следующие изменения в коллекцию сегментов :
- Все идентификаторы сегментов будут изменены с положительных целых чисел на буквенно-цифровые строки. Если вы сохранили идентификаторы сегментов пользователей, мы рекомендуем обновить их, чтобы использовать новые идентификаторы.
- Коллекция сегментов вернет только существующие сегменты уровня посещения . Новые сегменты посетителей, когорт и последовательностей в настоящее время не поддерживаются API.
- Коллекция сегментов продолжит возвращать существующие сегменты по умолчанию с теми же отрицательными числовыми идентификаторами, однако новые сегменты по умолчанию в настоящее время не поддерживаются.
Выпуск 05.06.2013 (5 июня 2013 г.)
В этом выпуске к ресурсу Webproperty добавлено 2 новых свойства:
-
profileCount
— возвращает количество профилей для свойства. Это позволяет фильтровать свойства, у которых нет профилей (т. е. ProfileCount = 0). -
industryVertical
— возвращает отраслевую вертикаль/категорию, выбранную для свойства.
Исправление ошибок:
- Свойство
eCommerceTracking
ресурса Profile теперь соответствует настройкам электронной торговли в разделе администрирования веб-интерфейса. Возвращаетtrue
, если отслеживание электронной торговли включено, иfalse
, если нет.
Выпуск от 08 мая 2013 г. (8 мая 2013 г.)
- Ресурс веб-ресурса теперь включает свойство
level
, указывающее, является ли веб-ресурсPREMIUM
илиSTANDARD
.
Выпуск от 04 апреля 2013 г. (4 апреля 2013 г.)
- В Management API v3 добавлена новая конечная точка для доступа к ресурсам экспериментов и их изменения.
Выпуск от 14 января 2013 г. (14 января 2013 г.)
- Ресурс профиля теперь включает свойство
type
, позволяющее определить, настроен ли профиль для веб-сайта или приложения. Два возможных значения:WEB
илиAPP
.
Выпуск 2012-01 (26 января 2012 г.)
В этом выпуске в Management API добавлены полезные ответы на ошибки.
- В тело ответов об ошибках API добавлены новые коды ошибок, причины и описания. Все коды документированы для обеих версий — версии 2.4 и версии 3.0 — Management API.
Выпуск 2011–12 (5 декабря 2011 г.)
В этом выпуске добавлены данные, изменены существующие функции и исправлена ошибка.
Новые данные
- Коллекция расширенных сегментов теперь содержит поле
segmentId
, которое можно использовать в параметре сегмента API экспорта данных.
Изменения
Тип данных для
max-results
был изменен наinteger
.Значение по умолчанию и максимальное значение для
max-results
было изменено на 1000.
Исправление ошибок
- Аккаунты, веб-ресурсы и профили для экспериментов Оптимизатора веб-сайтов Google больше не включаются в соответствующие коллекции.
Выпуск 2011-08 (29 августа 2011 г.)
В этом выпуске добавлены две новые версии API со множеством новых функций, а старая версия признана устаревшей. Изменения повлияют на то, как вы запрашиваете и обрабатываете данные из API.
Версия 3.0
Это последняя основная версия нашего API, которая не имеет обратной совместимости. Вся будущая разработка API будет осуществляться на основе этой версии.
Новые данные
- Полное представление целей мероприятия
- Внутренний идентификатор веб-ресурса, который можно использовать для глубокой ссылки на пользовательский интерфейс Google Analytics.
- Конфигурации профиля для параметров страницы по умолчанию и поискового запроса по сайту.
Изменения
- Новая политика квотирования
- Интеграция с консолью Google API для управления доступом к API и запроса дополнительных квот.
- Поддержка OAuth 2.0 как нового рекомендуемого способа авторизации пользователей.
- Новый URL-адрес для отправки запросов:
https://www.googleapis.com/analytics/v3/management/…
- Более компактный ответ API с использованием JSON
- Новые клиентские библиотеки Google API , поддерживающие гораздо больше языков.
- Поддержка API Google Discovery
Версия 2.4
Это незначительное обновление версии, которое в основном обратно совместимо с существующей версией 2.3.
Изменения
- Новая политика квотирования
- Интеграция с консолью Google API для управления доступом к API и запроса дополнительных квот.
- Продолжение поддержки существующих механизмов авторизации и OAuth 2.0.
- Новый URL-адрес для отправки запросов:
https://www.googleapis.com/analytics/v2.4/management/…
- Ответы только в XML
- Нет поддержки клиентской библиотеки Google Data JavaScript.
- Вывод XML соответствует версии 2.3, поэтому другие существующие клиентские библиотеки данных Google продолжат работать.
Устаревание
- Мы объявляем об прекращении поддержки устаревшей версии 2.3 Management API. Он продолжит работать в течение двух месяцев, после чего все запросы версии 2.3 будут возвращать ответ версии 2.4.
Выпуск 2010-08 (18 августа 2010 г.)
Это бета-версия API управления Google Analytics!
Новые каналы
Для упрощения доступа к данным конфигурации аккаунта Google Analytics было создано пять новых каналов:
Обновленные клиентские библиотеки
- Management API выпускается в той же библиотеке, что и API экспорта данных Google Analytics. Библиотеки Google Data Java и JavaScript были обновлены. Доступ к каждому каналу можно получить, указав соответствующий URI канала для метода библиотеки
getManagementFeed()
.
Новая документация
- В документации для разработчиков Google Analytics создан новый раздел, описывающий, как работает новый Management API .