Dokumentacja interfejsu VersionHistory API

Ta strona zawiera dokumentację techniczną dotyczącą interfejsu API usługi internetowej VersionHistory.

Cały dostęp do interfejsów API odbywa się przez HTTPS i jest uzyskiwany z https://versionhistory.googleapis.com/v1.

Wersja

Wersja to konkretne wystąpienie Chrome uruchomione przez użytkowników.

Pobieranie informacji o wersji dla danej platformy i kanału

Wyświetla 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.

Premiera

Wersja to okres, w którym użytkownicy korzystali z określonej wersji Chrome. Punkty końcowe wersji dostarczają też informacji o tym, jaka część użytkowników korzystała z danej wersji Chrome w danym przedziale czasu.

Pobierz wszystkie wersje

Wyświetla listę wszystkich wersji z 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
Fuchsia Web Engine fuchsiawebengine

Platforma

Platforma to jedna z platform obliczeniowych, na których działa produkt, np. Windows, Android itp.

Pobierz wszystkie platformy

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

Pobierz wszystkie kombinacje platformy i kanału

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ł

Informacje o kanałach Chrome znajdziesz w sekcji Jak wybrać kanał?.

Pobierz prawidłowe kanały platformy

Wyświetla listę kanałów prawidłowych dla danej platformy:

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

Identyfikatory kanału

Interfejs VersionHistory API obsługuje te identyfikatory kanałów:

Opis Wartość
Rozszerzona wersja stabilna extended
Stabilny stable
Beta beta
Dla programistów dev
Wyspy Kanaryjskie canary
Canary (kompilacja wariantu) canary_asan

Filtruj wyniki

Aby filtrować wyniki, dodaj parametr zapytania filter. Filtrowanie obsługują tylko punkty końcowe wersji i wersji. 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ę według odległości od wersji stabilnej, czyli stable < beta < dev < canary < canary_asan. Na przykład channel<=dev zwraca informacje stable, beta i dev.
  • Filtrowanie wersji jest przeprowadzane przy użyciu danych liczbowych, na przykład 1.0.0.8 < 1.0.0.10. Jeśli wersja nie jest w całości zapisana, w brakujących polach VersionHistory dołącza ciąg 0. Na przykład version>80 zmienia się w version>80.0.0.0.
  • Filtry endtime=none w przypadku wersji, które są aktualnie opublikowane i nie mają jeszcze ustalonej godziny zakończenia.
  • Jeśli filtrujesz według starttime lub endtime, wartość musi być w formacie ciągu znaków daty RFC 3339.
  • Dane name i platform są filtrowane według porównania ciągów znaków.
  • W przypadku wersji, które Chrome nadal udostępnia, pole serving.endtime nie będzie wypełnione. Podczas porządkowania lub filtrowania pole serving.endtime będzie traktowane jako 1970-01-01T00:00:00Z, jeśli to pole nie będzie wypełnione.
  • fraction służy do określenia, ilu użytkowników uczestniczyło we wdrożeniu. Na przykład fraction=1 oznacza 100% użytkowników.

Wyniki zamówienia

Dodaj parametr zapytania order_by do wyników sortowania. 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 listę wartości rozdzielonych przecinkami: version, name, platform, channel, starttime, endtime, fraction.

Po wartości order_by dodaj spację (%20), a po niej asc lub desc, aby określić kolejność rosnącą lub malejącą. Przykład:

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