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 untukstable
,beta
, dandev
. - Pemfilteran versi dilakukan secara numerik, misalnya
1.0.0.8
<1.0.0.10
. Jika versi tidak sepenuhnya ditulis, VersionHistory akan menambahkan0
untuk kolom yang tidak ada. Misalnya,version>80
menjadiversion>80.0.0.0
. endtime=none
memfilter rilis yang saat ini aktif dan belum memiliki waktu berakhir.- Saat memfilter menurut
starttime
atauendtime
, nilai harus dalam format string tanggal RFC 3339. name
danplatform
difilter menurut perbandingan string.- Untuk rilis yang masih ditayangkan oleh Chrome,
serving.endtime
tidak akan diisi. Selama pengurutan atau pemfilteran,serving.endtime
akan diperlakukan sebagai1970-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 berdasarkanplatform
,channel
,version
, laluserving.starttime
.