VersionHistory API referansı

Bu sayfada, VersionHistory web hizmeti API'si ile ilgili teknik referans bilgileri yer almaktadır.

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

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

Belirtilen 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ı.
channel Kanal tanımlayıcısı.

Lansman

Sürüm, kullanıcıların belirli bir Chrome sürümünü çalıştırmak için kullandığı aralıktır. Sürüm uç noktaları, ilgili zaman aralığında bu Chrome sürümünü kullanıcıların ne kadarlık kısmının çalıştırdığıyla ilgili bilgiler de sağlar.

Tüm sürümleri al

Belirtilen 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ı.
channel Kanal tanımlayıcısı.
version Sürüm tanımlayıcısı.

Ürün

Ürün, Chrome veya Fuchsia Web Engine gibi bir yazılım parçasıdır.

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

Açıklama Değer
Chrome chrome
Fuchsia Web Motoru fuchsiawebengine

Platform

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

Tüm platformları alma

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

Tüm platform ve kanal kombinasyonlarını al

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 kanallarının açıklaması için Hangi kanalı kullanacağımı nasıl seçerim? bölümüne bakın.

Bir platformun geçerli kanallarını alma

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ı.

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 yapısı) canary_asan

Sonuçlara filtre uygulama

Sonuçları filtrelemek için bir 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, virgülle ayrılmış bir ifade 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 platformuna olan mesafeye göre yapılır. Diğer bir deyişle, stable < beta < dev < canary < canary_asan. Örneğin channel<=dev; stable, beta ve dev için bilgileri döndürür.
  • Sürüm filtrelemesi sayısal olarak yapılır (örneğin, 1.0.0.8 < 1.0.0.10). Bir sürüm tamamen yazılmazsa VersionHistory eksik alanlar için 0 ifadesini ekler. Örneğin, version>80 değeri version>80.0.0.0 olur.
  • Şu anda yayında olan ve henüz bitiş zamanı olmayan sürümler için endtime=none filtresi.
  • 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â sunmakta olduğu sürümler için serving.endtime doldurulmaz. Alan doldurulmazsa sıralama veya filtreleme sırasında serving.endtime, 1970-01-01T00:00:00Z olarak değerlendirilir.
  • fraction, kullanıma sunma sürecine dahil olan kullanıcı sayısını 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 bir order_by sorgu parametresi ekleyin. Sıralama yalnızca sürüm ve sürüm uç noktaları tarafından desteklenir. Ö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 değerinden önce azalan sırada yer alır.
  • order_by belirtilmediğinde varsayılan sıralama platform, channel, version ve ardından serving.starttime olur.