Справочник по API истории версий

На этой странице содержится техническая справочная информация об API веб-службы VersionHistory.

Весь доступ к API осуществляется через HTTPS и доступен по адресу https://versionhistory.googleapis.com/v1 .

Версия

Версия – это конкретный экземпляр Chrome, который используют пользователи.

Получить информацию о версии для данной платформы и канала.

Перечисляет все версии Chrome для данной платформы и канала.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Имя Описание
product Идентификатор продукта .
platform Идентификатор платформы .
channel Идентификатор канала .

Выпускать

Релиз — это интервал, в течение которого пользователи использовали определенную версию Chrome. Конечные точки выпуска также предоставляют информацию о том, какая часть пользователей использовала эту версию Chrome в течение этого интервала.

Получить все выпуски

Перечисляет все выпуски для данной платформы, канала и версии.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Имя Описание
product Идентификатор продукта .
platform Идентификатор платформы .
channel Идентификатор канала .
version Идентификатор версии.

Продукт

Продукт — это часть программного обеспечения, например Chrome или Fuchsia Web Engine.

Идентификаторы продуктов

Описание Ценить
Хром chrome
Веб-движок фуксии fuchsiawebengine

Платформа

Платформа — это одна из вычислительных платформ, на которых работает продукт, например Windows, Android и т. д.

Получить все платформы

GET /{product}/platforms
Имя Описание
product Идентификатор продукта .

Получите все комбинации платформ и каналов.

GET /{product}/platforms/all/channels
Имя Описание
product Идентификатор продукта .

Идентификаторы платформы

Описание Ценить
Все платформы all
Окна win
Windows (64-разрядная версия) win64
Мак mac
Мак (ARM64) mac_arm64
Линукс linux
Андроид android
Веб-представление webview
iOS ios
Лакрос lacros

Канал

См. раздел Как выбрать, какой канал использовать? для объяснения каналов Chrome.

Получите действительные каналы платформы

Перечисляет действительные каналы для данной платформы:

GET /{product}/platforms/{platform}/channels
Имя Описание
product Идентификатор продукта .
platform Идентификатор платформы .

Идентификаторы каналов

API VersionHistory поддерживает следующие идентификаторы каналов:

Описание Ценить
Расширенная стабильная версия extended
Стабильный stable
Бета beta
Дев dev
Канарейка canary
Канарейка (вариант сборки) canary_asan

Фильтровать результаты

Добавьте параметр запроса filter , чтобы фильтровать результаты. Только конечные точки версии и выпуска поддерживают фильтрацию. Пример:

GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1

Значением filter должен быть список выражений, разделенных запятыми. Каждое выражение должно иметь форму field operator value .

Элемент Допустимые значения
Поле version , name , platform , starttime *, endtime *, fraction *
Оператор < , <= , = , > , >=
  • Фильтрация каналов осуществляется по расстоянию от Stable, другими словами stable < beta < dev < canary < canary_asan . Например, channel<=dev возвращает информацию для stable , beta и dev .
  • Фильтрация версий выполняется численно, например 1.0.0.8 < 1.0.0.10 . Если версия записана не полностью, VersionHistory добавляет 0 к отсутствующим полям. Например, version>80 становится version>80.0.0.0 .
  • endtime=none фильтрует выпуски, которые в настоящее время доступны и еще не имеют времени окончания.
  • При фильтрации по starttime или endtime значение должно быть в формате строки даты RFC 3339 .
  • name и platform фильтруются путем сравнения строк.
  • Для выпусков, которые Chrome все еще обслуживает, serving.endtime не будет заполнен. Во время упорядочивания или фильтрации serving.endtime будет обрабатываться как 1970-01-01T00:00:00Z , если поле не заполнено.
  • fraction используется для указания количества пользователей, участвующих в развертывании. Например, fraction=1 означает 100 % пользователей.

Результаты заказа

Добавьте параметр запроса order_by для упорядочивания результатов. Упорядочение поддерживают только конечные точки версии и выпуска . Пример:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime

order_by принимает список следующих значений, разделенных запятыми: version , name , platform , channel , starttime , endtime , fraction .

Добавьте символ пробела ( %20 ), а затем по asc или desc после значения order_by , чтобы указать порядок по возрастанию или убыванию. Пример:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Порядок каналов осуществляется в следующем порядке: stable , beta , dev , canary , canary_asan .
  • Упорядочение по name может привести к неожиданному поведению, поскольку это простая сортировка строк. Например, 1.0.0.8 будет предшествовать 1.0.0.10 в порядке убывания.
  • Если order_by не указан, порядок по умолчанию осуществляется по platform , channel , version , а затем serving.starttime .