VersionHistory API 参考文档

本页面包含有关 VersionHistory 网络服务 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 网络引擎 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

频道

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

获取平台的有效渠道

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

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

频道标识符

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

说明 价值
扩展稳定版 extended
稳定 stable
Beta 版 beta
开发版 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。