Referensi VersionHistory API

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

Semua akses API dilakukan 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 tertentu.

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 tentang pecahan 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 adalah bagian dari software seperti Chrome atau Fuchsia Web Engine.

Pengenal produk

Deskripsi Nilai
Chrome chrome
Fuchsia Web Engine fuchsiawebengine

Platform

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

Mendapatkan 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

Saluran

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

Mendapatkan channel 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
Dev dev
Canary canary
Canary (build varian) canary_asan

Filter hasil

Tambahkan parameter kueri filter untuk memfilter hasil. Hanya endpoint version dan release 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 hilang. Misalnya, version>80 menjadi version>80.0.0.0.
  • endtime=none memfilter rilis yang saat ini ditayangkan dan belum memiliki waktu berakhir.
  • Saat memfilter menurut starttime atau endtime, nilai harus dalam format string tanggal RFC 3339.
  • name dan platform difilter berdasarkan perbandingan string.
  • Untuk rilis yang masih ditayangkan 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.

Mengurutkan hasil

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

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

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

Tambahkan karakter spasi (%20) diikuti dengan asc atau desc setelah nilai order_by untuk menentukan pengurutan 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.
  • Pengurutan menurut name dapat menyebabkan perilaku yang tidak terduga karena merupakan pengurutan string sederhana. Misalnya, 1.0.0.8 akan berada sebelum 1.0.0.10 dalam urutan menurun.
  • Jika order_by tidak ditentukan, pengurutan default adalah menurut platform, channel, version, lalu serving.starttime.