VersionHistory API referansı

Bu sayfada, VersionHistory web hizmeti API'si hakkında teknik referans bilgileri yer alır.

Tüm API erişimi HTTPS üzerinden yapılıyor ve https://versionhistory.googleapis.com/v1 üzerinden erişiliyor.

Sürüm

Sürüm, kullanıcıların çalıştırdığı belirli bir Chrome örneğidir.

Belirli bir platform ve kanal için sürüm bilgilerini alma

Belirli bir platform ve kanal için tüm Chrome sürümlerini listeler.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Ad Açıklama
product Ürün tanımlayıcısı.
platform Platform tanımlayıcısı.
channel Kanal tanımlayıcısı

Lansman

Sürüm, kullanıcıların belirli bir Chrome sürümünü çalıştırdıkları aralıktır. Sürüm uç noktaları, ilgili zaman aralığında Chrome'un ilgili sürümünü çalıştıran kullanıcıların oranı hakkında da bilgi sağlar.

Tüm sürümleri al

Belirli bir platform, kanal ve sürüm için tüm sürümleri listeler.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Ad Açıklama
product Ürün tanımlayıcısı.
platform Platform tanımlayıcısı.
channel Kanal tanımlayıcısı
version Sürüm tanımlayıcısı.

Ürün

Ürün, Chrome veya Fuşya Web Motoru gibi bir yazılımdır.

Ürün tanımlayıcıları

Açıklama Değer
Chrome chrome
Fuşya Web Motoru fuchsiawebengine

Platform

Platform, bir ürünün çalıştırıldığı Windows, Android gibi bilgi işlem platformlarından biridir.

Tüm platformları al

GET /{product}/platforms
Ad Açıklama
product Ürün tanımlayıcısı.

Tüm platform ve kanal kombinasyonlarını alma

GET /{product}/platforms/all/channels
Ad Açıklama
product Ürün tanımlayıcısı.

Platform tanımlayıcıları

Açıklama Değer
Tüm platformlar all
Windows win
Windows (64 bit) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Lacros lacros

Kanal

Chrome'un kanallarıyla ilgili açıklama için Hangi kanalı kullanacağımı nasıl seçebilirim? bölümüne bakın.

Platformun geçerli kanallarını alın

Belirli bir platform için geçerli kanalları listeler:

GET /{product}/platforms/{platform}/channels
Ad Açıklama
product Ürün tanımlayıcısı.
platform Platform tanımlayıcısı.

Kanal tanımlayıcıları

VersionHistory API, aşağıdaki kanal tanımlayıcılarını destekler:

Açıklama Değer
Genişletilmiş Kararlı extended
Kararlı stable
Beta beta
Dev dev
Canary canary
Canary (varyant derlemesi) canary_asan

Sonuçları filtrele

Sonuçları filtrelemek için filter sorgu parametresi ekleyin. Yalnızca sürüm ve sürüm uç noktaları filtrelemeyi destekler. Örnek:

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

filter değeri, ifadelerin virgülle ayrılmış listesi olmalıdır. Her ifade field operator value biçiminde olmalıdır.

Öğe Geçerli değerler
Alan version, name, platform, starttime*, endtime*, fraction*
Operatör <, <=, =, >, >=
  • Kanal filtreleme, Mevcut ürün ile olan mesafeye göre yapılır. Başka bir deyişle stable < beta < dev < canary < canary_asan. Örneğin channel<=dev; stable, beta ve dev ile ilgili bilgileri döndürür.
  • Sürüm filtreleme sayısal olarak yapılır. Örneğin 1.0.0.8 < 1.0.0.10. Bir sürüm tamamen yazılmamışsa VersionHistory, eksik alanlara 0 ekler. Örneğin, version>80, version>80.0.0.0 haline gelir.
  • endtime=none filtreleri, şu anda yayında olan ve henüz bitiş zamanı olmayan sürümler için geçerlidir.
  • starttime veya endtime ölçütüne göre filtrelendiğinde değer, RFC 3339 tarih dizesi biçiminde olmalıdır.
  • name ve platform dize karşılaştırmasına göre filtrelendi.
  • Chrome'un hâlâ yayınlamakta olduğu sürümler için serving.endtime doldurulmaz. Sıralama veya filtreleme sırasında, alan doldurulmazsa serving.endtime, 1970-01-01T00:00:00Z olarak değerlendirilir.
  • fraction, kullanıma sunma sürecine kaç kullanıcının dahil olduğunu belirtmek için kullanılır. Örneğin, fraction=1, kullanıcıların% 100'ü anlamına gelir.

Sipariş sonuçları

Sonuçları sıralamak için order_by sorgu parametresi ekleyin. Yalnızca sürüm ve sürüm uç noktaları sıralamayı destekler. Örnek:

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

order_by, şu değerlerin virgülle ayrılmış listesini kabul eder: version, name, platform, channel, starttime, endtime, fraction.

Artan veya azalan sıralamayı belirtmek için bir boşluk karakteri (%20) ve ardından order_by değerinden sonra asc veya desc ekleyin. Örnek:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Kanal sıralaması şu sırayla yapılır: stable, beta, dev, canary, canary_asan.
  • name ölçütüne göre sıralama, naif bir dize sıralaması olduğundan beklenmeyen davranışlara neden olabilir. Örneğin 1.0.0.8, 1.0.0.10'dan önce azalan sıradadır.
  • order_by belirtilmediğinde varsayılan sıralama platform, channel, version ve ardından serving.starttime olur.