Referensi VersionHistory API

Halaman ini berisi informasi referensi teknis tentang API layanan web VersionHistory.

Semua akses API melalui HTTPS, dan diakses dari https://versionhistory.googleapis.com/v1.

Versi

Versi adalah instance Chrome tertentu yang dijalankan pengguna.

Mendapatkan informasi versi untuk platform dan saluran tertentu

Mencantumkan semua versi Chrome untuk platform dan saluran yang ditentukan.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Nama Deskripsi
product Kode produk.
platform ID platform.
channel ID channel.

Rilis

Rilis adalah interval saat pengguna menjalankan versi Chrome tertentu. Endpoint rilis juga memberikan informasi sekitar jumlah pengguna yang menjalankan versi Chrome tersebut selama interval tersebut.

Mendapatkan semua rilis

Mencantumkan semua rilis untuk platform, saluran, dan versi tertentu.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Nama Deskripsi
product Kode produk.
platform ID platform.
channel ID channel.
version ID versi.

Produk

Produk merupakan bagian software seperti Chrome atau Fuchsia Web Engine.

Pengenal produk

Deskripsi Nilai
Chrome chrome
Mesin Web Fuchsia fuchsiawebengine

Platform

Platform adalah salah satu platform komputasi tempat produk dijalankan, seperti Windows, Android, dll.

Dapatkan semua platform

GET /{product}/platforms
Nama Deskripsi
product Kode produk.

Mendapatkan semua kombinasi platform dan saluran

GET /{product}/platforms/all/channels
Nama Deskripsi
product Kode produk.

ID platform

Deskripsi Nilai
Semua platform all
Windows win
Windows (64 bit) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Lacros lacros

Channel

Lihat Bagaimana cara memilih saluran yang akan digunakan? untuk mendapatkan penjelasan tentang saluran Chrome.

Mendapatkan saluran yang valid di platform

Mencantumkan saluran yang valid untuk platform tertentu:

GET /{product}/platforms/{platform}/channels
Nama Deskripsi
product Kode produk.
platform ID platform.

ID channel

VersionHistory API mendukung ID saluran berikut:

Deskripsi Nilai
Stabil yang Diperluas extended
Stabil stable
Beta beta
Pengembang dev
Canary canary
Canary (build varian) canary_asan

Filter hasil

Tambahkan parameter kueri filter untuk memfilter hasil. Hanya endpoint versi dan rilis yang mendukung pemfilteran. Contoh:

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

Nilai filter harus berupa daftar ekspresi yang dipisahkan koma. Setiap ekspresi harus berbentuk field operator value.

Item Nilai valid
Kolom version, name, platform, starttime*, endtime*, fraction*
Operator <, <=, =, >, >=
  • Pemfilteran saluran dilakukan berdasarkan jarak dari Stabil, dengan kata lain stable < beta < dev < canary < canary_asan. Misalnya, channel<=dev menampilkan informasi untuk stable, beta, dan dev.
  • Pemfilteran versi dilakukan secara numerik, misalnya 1.0.0.8 < 1.0.0.10. Jika versi tidak sepenuhnya ditulis, VersionHistory akan menambahkan 0 untuk kolom yang tidak ada. Misalnya, version>80 menjadi version>80.0.0.0.
  • endtime=none memfilter rilis yang saat ini aktif dan belum memiliki waktu berakhir.
  • Saat memfilter menurut starttime atau endtime, nilai harus dalam format string tanggal RFC 3339.
  • name dan platform difilter menurut perbandingan string.
  • Untuk rilis yang masih ditayangkan oleh Chrome, serving.endtime tidak akan diisi. Selama pengurutan atau pemfilteran, serving.endtime akan diperlakukan sebagai 1970-01-01T00:00:00Z jika kolom tidak diisi.
  • fraction digunakan untuk menentukan jumlah pengguna yang terlibat dalam peluncuran. Misalnya, fraction=1 berarti 100% pengguna.

Hasil pesanan

Tambahkan parameter kueri order_by untuk mengurutkan hasil. Hanya endpoint versi dan rilis yang mendukung pengurutan. Contoh:

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

order_by menerima daftar yang dipisahkan koma untuk nilai berikut: version, name, platform, channel, starttime, endtime, fraction.

Tambahkan karakter spasi (%20) diikuti dengan asc atau desc setelah nilai order_by untuk menentukan urutan menaik atau menurun. Contoh:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Pengurutan saluran dilakukan dalam urutan berikut: stable, beta, dev, canary, canary_asan.
  • Mengurutkan berdasarkan name dapat menyebabkan perilaku yang tidak terduga karena ini merupakan pengurutan string yang naif. Misalnya, 1.0.0.8 akan berada sebelum 1.0.0.10 dalam urutan menurun.
  • Jika order_by tidak ditentukan, pengurutan defaultnya adalah berdasarkan platform, channel, version, lalu serving.starttime.