VersionHistory API referansı

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

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

Sürüm

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

Belirli bir platform ve kanalın 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ısı.
channel Kanal tanımlayıcısı.

Serbest bırak

Sürüm, kullanıcıların Chrome'un belirli bir sürümünü çalıştırdıkları aralıktır. Sürüm uç noktaları, kullanıcıların bu aralık boyunca Chrome'un hangi sürümünü kullandığıyla ilgili bilgi de sağlar.

Tüm sürümleri alma

Belirli bir platform, kanal ve sürümün tüm sürümlerini 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 Bir sürüm tanımlayıcısı.

Ürün

Ürün, Chrome veya Fuchsia Web Motoru 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 ç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ı 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
Yapay Zeka android
Web Görünümü webview
iOS ios
Lacros lacros

Kanal

Chrome kanallarıyla ilgili açıklama için Hangi kanalı kullanacağımı nasıl seçerim? başlıklı makaleyi inceleyin.

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ı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 version ve release 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 işlemi, kararlı sürüme 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 ile ilgili bilgileri döndürür.
  • Sürüm filtreleme işlemi sayısal olarak yapılır (ör. 1.0.0.8 < 1.0.0.10). Bir sürüm tamamen yazılmamışsa VersionHistory, eksik alanlar için 0 ekler. Örneğin, version>80 version>80.0.0.0 olur.
  • endtime=none, şu anda yayınlanmakta olan ve henüz bitiş zamanı olmayan yayınları filtreler.
  • starttime veya endtime'e göre filtreleme yaparken değer RFC 3339 tarih dizesi biçiminde olmalıdır.
  • name ve platform, dize karşılaştırmasına göre filtrelenir.
  • Chrome'un hâlâ yayınladığı 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 işlemine kaç kullanıcının dahil edildiğini belirtmek için kullanılır. Örneğin, fraction=1 kullanıcıların% 100'ünü ifade eder.

Sıralama sonuçları

Sonuçları sıralamak için order_by sorgu parametresi ekleyin. Sıralama yalnızca version ve release uç noktalarında desteklenir. Örnek:

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

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

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

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Kanal sıralaması şu şekilde yapılır: stable, beta, dev, canary, canary_asan.
  • Basit bir dize sıralaması olduğu için name'ye göre sıralama yapmak beklenmedik davranışlara neden olabilir. Örneğin, 1.0.0.8 azalan düzende 1.0.0.10'dan önce gelir.
  • order_by belirtilmediğinde varsayılan sıralama platform, channel, version ve ardından serving.starttime'e göre yapılır.