VersionHistory API 參考資料

本頁包含 VersionHistory 網路服務 API 的技術參考資料資訊。

所有 API 存取權都是透過 HTTPS 進行，且可從 https://versionhistory.googleapis.com/v1 存取。

版本

版本是指使用者正在執行的 Chrome 特定執行個體。

取得指定平台和版本的版本資訊

列出指定平台和版本的所有 Chrome 版本。

GET /{product}/platforms/{platform}/channels/{channel}/versions
名稱 說明
product 產品 ID。
platform 平台 ID。
channel 頻道 ID。

發布

發布版本是指使用者執行特定 Chrome 版本的間隔時間。發布端點也會提供在該間隔內執行該 Chrome 版本之使用者相關資訊的資訊。

取得所有版本

列出指定平台、版本和版本的所有版本。

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
名稱 說明
product 產品 ID。
platform 平台 ID。
channel 頻道 ID。
version 版本 ID。

產品

產品是 Chrome 或 Fuchsia Web Engine 等軟體的一部分。

商品識別項

說明 價值
Chrome chrome
Fuchsia Web Engine fuchsiawebengine

平台

平台是產品執行的其中一個運算平台，例如 Windows、Android 等。

取得所有平台

GET /{product}/platforms
名稱 說明
product 產品 ID。

取得所有平台和管道組合

GET /{product}/platforms/all/channels
名稱 說明
product 產品 ID。

平台 ID

說明 價值
所有平台 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 產品 ID。
platform 平台 ID。

頻道 ID

VersionHistory API 支援下列頻道 ID：

說明 價值
擴充穩定版 extended
穩定 stable
Beta 版 beta
開發 dev
Canary 版 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 < 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。