Tài liệu tham khảo API VersionLịch sử

Trang này chứa thông tin tham khảo kỹ thuật về API dịch vụ web VersionHistory.

Tất cả quyền truy cập API đều qua HTTPS và được truy cập từ https://versionhistory.googleapis.com/v1.

Phiên bản

Phiên bản là một phiên bản Chrome cụ thể mà người dùng đang chạy.

Nhận thông tin phiên bản cho một nền tảng và kênh cụ thể

Liệt kê tất cả phiên bản Chrome cho nền tảng và kênh nhất định.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Tên Mô tả
product Mã nhận dạng sản phẩm.
platform Giá trị nhận dạng nền tảng.
channel Mã nhận dạng kênh.

Bản phát hành

Bản phát hành là khoảng thời gian người dùng chạy một phiên bản Chrome cụ thể. Các điểm cuối phát hành cũng cung cấp thông tin về tỷ lệ phần trăm người dùng đang chạy phiên bản Chrome đó trong khoảng thời gian đó.

Tải tất cả bản phát hành

Liệt kê tất cả bản phát hành cho nền tảng, kênh và phiên bản nhất định.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Tên Mô tả
product Mã nhận dạng sản phẩm.
platform Giá trị nhận dạng nền tảng.
channel Mã nhận dạng kênh.
version Giá trị nhận dạng phiên bản.

Sản phẩm

Sản phẩm là một phần mềm như Chrome hoặc Công cụ web Fuchsia.

Mã nhận dạng sản phẩm

Mô tả Giá trị
Chrome chrome
Công cụ web Fuchsia fuchsiawebengine

Nền tảng

Nền tảng là một trong các nền tảng điện toán mà sản phẩm chạy trên đó, chẳng hạn như Windows, Android, v.v.

Nhận tất cả nền tảng

GET /{product}/platforms
Tên Mô tả
product Mã nhận dạng sản phẩm.

Nhận tất cả các tổ hợp nền tảng và kênh

GET /{product}/platforms/all/channels
Tên Mô tả
product Mã nhận dạng sản phẩm.

Giá trị nhận dạng nền tảng

Mô tả Giá trị
Tất cả các nền tảng all
Windows win
Windows (64-bit) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Lacros lacros

Kênh

Hãy xem bài viết Làm cách nào để chọn kênh sử dụng? để biết nội dung giải thích về các kênh của Chrome.

Lấy các kênh hợp lệ của một nền tảng

Liệt kê các kênh hợp lệ cho một nền tảng cụ thể:

GET /{product}/platforms/{platform}/channels
Tên Mô tả
product Mã nhận dạng sản phẩm.
platform Giá trị nhận dạng nền tảng.

Giá trị nhận dạng kênh

API VersionHistory hỗ trợ các giá trị nhận dạng kênh sau:

Mô tả Giá trị
Phiên bản chính thức mở rộng extended
Ổn định stable
Beta beta
Nhà phát triển dev
Canary canary
Canary (bản dựng biến thể) canary_asan

Lọc kết quả

Thêm tham số truy vấn filter để lọc kết quả. Chỉ các điểm cuối phiên bản và bản phát hành mới hỗ trợ tính năng lọc. Ví dụ:

GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1

Giá trị của filter phải là danh sách các biểu thức được phân tách bằng dấu phẩy. Mỗi biểu thức phải có dạng field operator value.

Mục Giá trị hợp lệ
Trường version, name, platform, starttime*, endtime*, fraction*
Đơn vị tổ chức <, <=, =, >, >=
  • Việc lọc kênh được thực hiện theo khoảng cách từ phiên bản ổn định, tức là stable < beta < dev < canary < canary_asan. Ví dụ: channel<=dev trả về thông tin cho stable, beta và dev.
  • Việc lọc phiên bản được thực hiện theo số, ví dụ: 1.0.0.8 < 1.0.0.10. Nếu một phiên bản không được viết hoàn toàn, VersionHistory sẽ thêm 0 cho các trường bị thiếu. Ví dụ: version>80 trở thành version>80.0.0.0.
  • Bộ lọc endtime=none cho các bản phát hành hiện đang hoạt động và chưa có thời gian kết thúc.
  • Khi lọc theo starttime hoặc endtime, giá trị phải ở định dạng chuỗi ngày RFC 3339.
  • name và platform được lọc bằng cách so sánh chuỗi.
  • Đối với các bản phát hành mà Chrome vẫn đang phân phát, serving.endtime sẽ không được điền sẵn. Trong quá trình sắp xếp hoặc lọc, serving.endtime sẽ được coi là 1970-01-01T00:00:00Z nếu trường này không được điền.
  • fraction được dùng để chỉ định số lượng người dùng đã tham gia vào quá trình triển khai. Ví dụ: fraction=1 có nghĩa là 100% người dùng.

Sắp xếp kết quả

Thêm tham số truy vấn order_by để sắp xếp kết quả. Chỉ các điểm cuối phiên bản và bản phát hành mới hỗ trợ việc đặt hàng. Ví dụ:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime

order_by chấp nhận danh sách được phân tách bằng dấu phẩy gồm các giá trị sau: version, name, platform, channel, starttime, endtime, fraction.

Thêm một ký tự dấu cách (%20) theo sau là asc hoặc desc sau giá trị order_by để chỉ định thứ tự tăng dần hoặc giảm dần. Ví dụ:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Thứ tự kênh được thực hiện theo thứ tự sau: stable, beta, dev, canary, canary_asan.
  • Việc sắp xếp theo name có thể gây ra hành vi không mong muốn vì đây là một cách sắp xếp chuỗi đơn giản. Ví dụ: 1.0.0.8 sẽ đứng trước 1.0.0.10 theo thứ tự giảm dần.
  • Khi không chỉ định order_by, thứ tự mặc định sẽ là platform, channel, version, sau đó là serving.starttime.