VersionHistory API 参考文档

本页面包含有关 VersionHistory Web 服务 API 的技术参考信息。

所有 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 chrome
Fuchsia Web Engine fuchsiawebengine

平台

平台是指产品运行的计算平台之一，例如 Windows、Android 等。

获取所有平台

GET /{product}/platforms
名称 说明
product 商品标识码。

获取所有平台和渠道组合

GET /{product}/platforms/all/channels
名称 说明
product 商品标识码。

平台标识符

说明 值
所有平台 all
Windows win
Windows（64 位） win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Lacros lacros

频道

如需了解 Chrome 的渠道，请参阅如何选择要使用的渠道？。

获取平台的有效渠道

列出给定平台的有效渠道：

GET /{product}/platforms/{platform}/channels
名称 说明
product 商品标识码。
platform 平台标识符。

渠道标识符

VersionHistory API 支持以下渠道标识符：

说明 值
扩展稳定版 extended
稳定 stable
测试版 beta
Dev dev
Canary 版 canary
Canary（变体 build） 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 < 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。

在 order_by 值后面添加空格字符 (%20) 和 asc 或 desc，以指定升序或降序排序。示例：

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。