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 形式。

商品 有效值
字段 versionnameplatformstarttime*、endtime*、fraction*
运算符 <<==>>=
  • 频道过滤是根据与稳定渠道的距离进行的,也就是说,stable < beta < dev < canary < canary_asan。例如,channel<=dev 会返回 stablebetadev 的信息。
  • 版本过滤以数字方式完成,例如 1.0.0.8 < 1.0.0.10。如果某个版本未完全写入,VersionHistory 会为缺失的字段附加 0。例如,version>80 会变为 version>80.0.0.0
  • endtime=none 用于过滤当前已发布且尚未设置结束时间的版本。
  • starttimeendtime 过滤时,值必须采用 RFC 3339 日期字符串格式。
  • 按字符串比较过滤 nameplatform
  • 对于 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 接受以下值的英文逗号分隔列表:versionnameplatformchannelstarttimeendtimefraction

order_by 值后面添加一个空格字符 (%20),后跟 ascdesc,以指定升序或降序。例如:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • 通道按以下顺序完成:stablebetadevcanarycanary_asan
  • name 排序可能会导致意外行为,因为这是一种简单的字符串排序。例如,1.0.0.8 将排在 1.0.0.10 之前,按降序排列。
  • 如果未指定 order_by,则默认排序方式是 platformchannelversionserving.starttime