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 網路引擎 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，系統會將 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。