Dokumentacja interfejsu VersionHistory API

Ta strona zawiera informacje techniczne dotyczące interfejsu API usługi internetowej VersionHistory.

Cały dostęp do interfejsu API odbywa się przez HTTPS, z poziomu https://versionhistory.googleapis.com/v1.

Wersja

Wersja to konkretna instancja Chrome uruchomiona przez użytkowników.

Uzyskiwanie informacji o wersji danej platformy i kanału

Zawiera listę wszystkich wersji Chrome dla danej platformy i kanału.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Nazwa Opis
product Identyfikator produktu.
platform Identyfikator platformy.
channel Identyfikator kanału.

Wersja

Wersja to przedział czasu, w którym użytkownicy korzystali z konkretnej wersji Chrome. Punkty końcowe wersji zawierają też informacje o tym, jaki odsetek użytkowników używał danej wersji Chrome w danym przedziale czasu.

Pobierz wszystkie wersje

Zawiera listę wszystkich wersji dla danej platformy, kanału i wersji.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Nazwa Opis
product Identyfikator produktu.
platform Identyfikator platformy.
channel Identyfikator kanału.
version Identyfikator wersji.

Produkt

Produkt to program, np. Chrome lub Fuchsia Web Engine.

Identyfikatory produktu

Opis Wartość
Chrome chrome
Mechanizm internetowy Fuchsia fuchsiawebengine

Platforma

Platforma to jedna z platform komputerowych, na których działa usługa, np. Windows, Android itp.

Wszystkie platformy

GET /{product}/platforms
Nazwa Opis
product Identyfikator produktu.

Pobierz wszystkie kombinacje platform i kanałów

GET /{product}/platforms/all/channels
Nazwa Opis
product Identyfikator produktu.

Identyfikatory platformy

Opis Wartość
Wszystkie platformy all
Windows win
Windows (64-bitowy) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Lacros lacros

Kanał

Omówienie kanałów Chrome znajdziesz w sekcji Jak wybrać kanał?.

Pobierz prawidłowe kanały platformy

Lista prawidłowych kanałów dla danej platformy:

GET /{product}/platforms/{platform}/channels
Nazwa Opis
product Identyfikator produktu.
platform Identyfikator platformy.

Identyfikatory kanałów

Interfejs VersionHistory API obsługuje następujące identyfikatory kanałów:

Opis Wartość
Stabilny rozszerzony extended
Stabilny stable
Beta beta
Dla programistów dev
Canary canary
Canary (wersja wariantu) canary_asan

Filtruj wyniki

Aby filtrować wyniki, dodaj parametr zapytania filter. Tylko punkty końcowe wersji i wersji obsługują filtrowanie. Przykład:

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

Wartość filter powinna być listą wyrażeń rozdzielonych przecinkami. Każde wyrażenie powinno mieć postać field operator value.

Element Prawidłowe wartości
Pole version, name, platform, starttime*, endtime*, fraction*
Operator <, <=, =, >, >=
  • Filtrowanie kanałów odbywa się na podstawie odległości od kanału stabilnego, czyli stable < beta < dev < canary < canary_asan. Na przykład channel<=dev zwraca informacje dotyczące stable, beta i dev.
  • Filtrowanie wersji odbywa się za pomocą liczb, na przykład 1.0.0.8 < 1.0.0.10. Jeśli wersja nie została w pełni napisana, historia wersji dołącza w przypadku brakujących pól 0. Na przykład version>80 zmieni się na version>80.0.0.0.
  • endtime=none filtruje wersje, które są obecnie opublikowane, ale nie mają jeszcze godziny zakończenia.
  • W przypadku filtrowania według właściwości starttime lub endtime wartość musi być w formacie ciągu znaków daty RFC 3339.
  • Elementy name i platform są filtrowane według porównania ciągów znaków.
  • W przypadku wersji, które Chrome nadal wyświetla, pole serving.endtime nie będzie wypełniane. Jeśli pole nie zostanie wypełnione, podczas sortowania lub filtrowania pole serving.endtime będzie traktowane jako 1970-01-01T00:00:00Z.
  • fraction służy do określania liczby użytkowników uczestniczących we wdrożeniu. Na przykład fraction=1 oznacza wszystkich użytkowników.

Wyniki wyszukiwania

Do sortowania wyników dodaj parametr zapytania order_by. Tylko punkty końcowe wersji i wersji obsługują kolejność. Przykład:

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

order_by akceptuje rozdzieloną przecinkami listę tych wartości: version, name, platform, channel, starttime, endtime, fraction.

Aby określić kolejność rosnącą lub malejącą, po wartości order_by dodaj znak spacji (%20), a po niej ciąg asc lub desc. Przykład:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Kanały mogą być uporządkowane w następującej kolejności: stable, beta, dev, canary, canary_asan.
  • Sortowanie według name może spowodować nieoczekiwane zachowanie, ponieważ jest to naiwne sortowanie ciągów znaków. Na przykład 1.0.0.8 będzie przed 1.0.0.10 w kolejności malejącej.
  • Jeśli zasada order_by nie jest określona, domyślna kolejność jest taka: platform, channel, version, a później serving.starttime.