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 Version History.

Mọi 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 cụ thể của Chrome mà người dùng đang chạy.

Xem 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ả các phiên bản Chrome của 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ệ người dùng chạy phiên bản Chrome đó trong khoảng thời gian đó.

Tải 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 mềm 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 những 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 kiểu kết hợp 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 phần 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.

Xem các kênh hợp lệ của 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 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 VersionNhật ký hỗ trợ các giá trị nhận dạng kênh sau đây:

Nội dung 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ác điểm cuối của 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 biểu thức được phân tách bằng dấu phẩy. Mỗi biểu thức sẽ có dạng field operator value.

Mục Giá trị hợp lệ
Trường version, name, platform, starttime*, endtime*, fraction*
Nhà điều hành <, <=, =, >, >=
  • Quá trình lọc kênh được thực hiện theo khoảng cách từ 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 bằng 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ì Version History 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 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ối, serving.endtime sẽ không được điền vào. Trong khi đặt hàng 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 phát hành. Ví dụ: fraction=1 có nghĩa là 100% người dùng.

Kết quả đặt món

Thêm tham số truy vấn order_by để sắp xếp kết quả. Chỉ có các điểm cuối của phiên bản và bản phát hành mới hỗ trợ thứ tự. 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 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
  • Bạn có thể sắp xếp thứ tự kênh 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 kiểu sắp xếp cơ bản. 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.