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 (變化版本) canary_asan

篩選結果

新增 filter 查詢參數來篩選結果。只有 version 和 release 端點支援篩選功能。範例：

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 查詢參數來排序結果。只有 version 和 release 端點支援排序。範例：

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。