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ładchannel<=dev
zwraca informacjestable
,beta
idev
. - 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ąg0
. Na przykładversion>80
zmienia się wversion>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
lubendtime
, wartość musi być w formacie ciągu znaków daty RFC 3339. - Dane
name
iplatform
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 poleserving.endtime
będzie traktowane jako1970-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ładfraction=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 pole1.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 toplatform
,channel
,version
, a następnieserving.starttime
.