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 vào 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 của một nền tảng và kênh cụ thể

Liệt kê tất cả phiên bản Chrome dành cho nền tảng và kênh cụ thể.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Tên Nội dung mô tả
product Mã nhận dạng sản phẩm.
platform Giá trị nhận dạng nền tảng.
channel Giá trị 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 đó.

Xem tất cả các bản phát hành

Liệt kê tất cả các bản phát hành của nền tảng, kênh và phiên bản cụ thể.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Tên Nội dung mô tả
product Mã nhận dạng sản phẩm.
platform Giá trị nhận dạng nền tảng.
channel Giá trị 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 của phần mềm, chẳng hạn như Chrome hoặc Fuchsia Web Engine.

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

Nội dung 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.

Tải tất cả nền tảng

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

Xem mọi cách kết hợp giữa nền tảng và kênh

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

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

Nội dung mô tả Giá trị
Tất cả nền tảng all
Windows win
Windows (64 bit) win64
Mac mac
Máy Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Bóng vợt lacros

Kênh

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

Xem các kênh hợp lệ của nền tảng

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

GET /{product}/platforms/{platform}/channels
Tên Nội dung 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 Lịch sử phiên bản hỗ trợ các giá trị nhận dạng kênh sau đây:

Nội dung mô tả Giá trị
Kênh 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ó đ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à một danh sách 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ệ
Kỹ thuật version, name, platform, starttime*, endtime*, fraction*
Đơn vị tổ chức <, <=, =, >, >=
  • Quá trình lọc kênh được thực hiện theo khoảng cách đến kênh chính thức, nói cách khác là stable < beta < dev < canary < canary_asan. Ví dụ: channel<=dev trả về thông tin cho stable, beta và dev.
  • Quá trình 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, thì 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 đang diễn ra 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 theo phép 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 khi 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 sẵn.
  • fraction dùng để chỉ định số lượng người dùng đã tham gia quá trình phát hành. Ví dụ: fraction=1 có nghĩa là 100% người dùng.

Kết quả đơn đặt hàng

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

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

order_by chấp nhận danh sách các giá trị sau được phân tách bằng dấu phẩy: 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
  • Kênh được sắp xếp 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à cách sắp xếp chuỗi ngây thơ. Ví dụ: 1.0.0.8 sẽ trước 1.0.0.10 theo thứ tự giảm dần.
  • Khi bạn không chỉ định order_by, thứ tự mặc định sẽ là platform, channel, version, sau đó là serving.starttime.