Dokumentacja interfejsu VersionHistory API

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

Dostęp do wszystkich interfejsów API jest realizowany przez HTTPS i można go uzyskać z poziomu https://versionhistory.googleapis.com/v1.

Wersja

Wersja to konkretny egzemplarz Chrome, który uruchamiają użytkownicy.

Pobieranie informacji o wersji na danej platformie i w danym kanale

Wyświetla listę wszystkich wersji Chrome na danej platformie i kanale.

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, jaka część użytkowników korzystała z tej wersji Chrome w danym przedziale czasu.

Pobieranie wszystkich wersji

Wyświetla wszystkie wersje na daną platformę, kanał i wersję.

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 element oprogramowania, np. Chrome lub silnik sieciowy Fuchsia.

Identyfikatory produktu

Opis Wartość
Chrome chrome
Silnik 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.

Pobieranie wszystkich kombinacji platform i kanałów

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

Identyfikatory platform

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

Kanał

Więcej informacji o kanałach Chrome znajdziesz w artykule Jak wybrać kanał?.

Wyświetlanie prawidłowych kanałów na platformie

Wyświetla listę prawidłowych kanałów na danej platformie:

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

Identyfikatory kanałów

Interfejs VersionHistory API obsługuje te identyfikatory kanału:

Opis Wartość
Rozszerzona stabilna extended
Stabilny stable
Beta beta
Deweloperzy dev
Canary canary
Canary (wersja z wariantami) canary_asan

Filtruj wyniki

Dodaj parametr zapytania filter, aby filtrować wyniki. Filtrowanie jest obsługiwane tylko w przypadku punktów końcowych version i release. 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 wersji stabilnej, czyli stable < beta < dev < canary < canary_asan. Na przykład channel<=dev zwraca informacje o wartościach stable, beta i dev.
  • Filtrowanie wersji odbywa się według wartości liczbowych, np. 1.0.0.8 < 1.0.0.10. Jeśli wersja nie jest w pełni zapisana, VersionHistory dołącza 0 do brakujących pól. Na przykład version>80 zmieni się na version>80.0.0.0.
  • endtime=none filtry dla wersji, które są obecnie dostępne i nie mają jeszcze określonego czasu zakończenia.
  • W przypadku filtrowania według atrybutów starttime lub endtime wartość musi być podana w formacie ciągu znaków daty RFC 3339.
  • Pola name i platform są filtrowane na podstawie porównania ciągu znaków.
  • W przypadku wersji, które Chrome nadal udostępnia, wartość serving.endtime nie będzie wypełniana. Podczas sortowania lub filtrowania, jeśli pole nie jest wypełnione, wartość serving.endtime będzie traktowana jako 1970-01-01T00:00:00Z.
  • Wartość fraction służy do określenia, ilu użytkowników uczestniczyło w wdrożeniu. Na przykład fraction=1 oznacza 100% użytkowników.

Zamawianie wyników

Dodaj parametr zapytania order_by, aby posortować wyniki. Sortowanie obsługują tylko punkty końcowe version i release. Przykład:

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

Parametr order_by przyjmuje listę wartości oddzielonych przecinkami: version, name, platform, channel, starttime, endtime, fraction.

Aby określić rosnący lub malejący porządek sortowania, dodaj po wartości order_by znak odstępu (%20), a potem asc lub desc. Przykład:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Kanały są sortowane w kolejności: stable, beta, dev, canary, canary_asan.
  • Sortowanie według name może powodować nieoczekiwane działanie, ponieważ jest to prosta operacja sortowania ciągu znaków. Na przykład 1.0.0.8 będzie poprzedzać 1.0.0.10 w kolejności malejącej.
  • Jeśli atrybut order_by nie jest określony, domyślna kolejność to platform, channel, version, a następnie serving.starttime.