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