Diese Seite enthält technische Referenzinformationen zur VersionHistory-Webdienst-API.
Der API-Zugriff erfolgt über HTTPS. Der Zugriff erfolgt über https://versionhistory.googleapis.com/v1
.
Version
Eine Version ist eine bestimmte Instanz von Chrome, die von Nutzern ausgeführt wird.
Versionsinformationen für eine bestimmte Plattform und einen bestimmten Kanal abrufen
Listet alle Chrome-Versionen für die jeweilige Plattform und den jeweiligen Kanal auf.
GET /{product}/platforms/{platform}/channels/{channel}/versions
Name | Beschreibung |
---|---|
product |
Eine Produktkennzeichnung. |
platform |
Eine Plattform-ID. |
channel |
Eine Kanal-ID. |
Release
Ein Release ist das Intervall, in dem Nutzer eine bestimmte Version von Chrome ausgeführt haben. Die Release-Endpunkte liefern auch Informationen darüber, welcher Anteil der Nutzer diese Chrome-Version in diesem Intervall ausgeführt hat.
Alle Releases abrufen
Listet alle Releases für die angegebene Plattform, den angegebenen Kanal und die angegebene Version auf.
GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Name | Beschreibung |
---|---|
product |
Eine Produktkennzeichnung. |
platform |
Eine Plattform-ID. |
channel |
Eine Kanal-ID. |
version |
Eine Versionskennung. |
Produkt
Ein Produkt ist eine Software wie Chrome oder Fuchsia Web Engine.
Produkt-IDs
Beschreibung | Wert |
---|---|
Chrome | chrome |
Fuchsia-Web-Engine | fuchsiawebengine |
Plattform
Eine Plattform ist eine der Rechenplattformen, auf denen ein Produkt ausgeführt wird, z. B. Windows oder Android.
Alle Plattformen abrufen
GET /{product}/platforms
Name | Beschreibung |
---|---|
product |
Eine Produktkennzeichnung. |
Alle Plattform- und Kanalkombinationen abrufen
GET /{product}/platforms/all/channels
Name | Beschreibung |
---|---|
product |
Eine Produktkennzeichnung. |
Plattformkennungen
Beschreibung | Wert |
---|---|
Alle Plattformen | all |
Windows | win |
Windows (64-Bit) | win64 |
Mac | mac |
Mac (ARM64) | mac_arm64 |
Linux | linux |
Android | android |
WebView | webview |
iOS | ios |
Lacros | lacros |
Kanal
Eine Erläuterung der Chrome-Versionen finden Sie unter Wie wähle ich die zu verwendende Version aus?.
Gültige Kanäle einer Plattform abrufen
Listet die gültigen Kanäle für eine bestimmte Plattform auf:
GET /{product}/platforms/{platform}/channels
Name | Beschreibung |
---|---|
product |
Eine Produktkennzeichnung. |
platform |
Eine Plattform-ID. |
Kanal-IDs
Die VersionHistory API unterstützt die folgenden Kanalkennungen:
Beschreibung | Wert |
---|---|
Erweiterte stabile Version | extended |
Stabil | stable |
Beta | beta |
Dev | dev |
Canary | canary |
Canary (Varianten-Build) | canary_asan |
Ergebnisse filtern
Fügen Sie einen filter
-Abfrageparameter hinzu, um Ergebnisse zu filtern. Nur die Versions- und Release-Endpunkte unterstützen die Filterung.
Beispiel:
GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1
Der Wert von filter
sollte eine durch Kommas getrennte Liste von Ausdrücken sein. Jeder Ausdruck sollte die Form field operator value
haben.
Element | Zulässige Werte |
---|---|
Feld |
version , name , platform ,
starttime *, endtime *, fraction *
|
Betreiber |
< , <= , = ,
> , >=
|
- Die Kanalfilterung erfolgt nach der Entfernung zur stabilen Version, d. h.
stable
<beta
<dev
<canary
<canary_asan
. Beispiel:channel<=dev
gibt Informationen zustable
,beta
unddev
zurück. - Die Versionsfilterung erfolgt numerisch, z. B.
1.0.0.8
<1.0.0.10
. Wenn eine Version nicht vollständig geschrieben wurde, hängt VersionHistory für die fehlenden Felder0
an. Ausversion>80
wird dann beispielsweiseversion>80.0.0.0
. endtime=none
filtert nach Releases, die derzeit live sind und noch kein Ende haben.- Beim Filtern nach
starttime
oderendtime
muss der Wert im Datumsstringformat RFC 3339 vorliegen. name
undplatform
werden durch Stringvergleich gefiltert.- Für Releases, die noch von Chrome bereitgestellt werden, wird
serving.endtime
nicht ausgefüllt. Beim Sortieren oder Filtern wirdserving.endtime
wie1970-01-01T00:00:00Z
behandelt, wenn das Feld nicht ausgefüllt ist. - Mit
fraction
wird angegeben, wie viele Nutzer an dem Roll-out beteiligt waren. Beispiel:fraction=1
steht für 100% der Nutzer.
Bestellergebnisse
Fügen Sie den Abfrageparameter order_by
hinzu, um die Ergebnisse zu sortieren. Nur die Endpunkte Version und Release unterstützen die Sortierung.
Beispiel:
GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime
order_by
akzeptiert eine durch Kommas getrennte Liste der folgenden Werte: version
, name
, platform
, channel
, starttime
, endtime
, fraction
.
Fügen Sie nach dem Wert order_by
ein Leerzeichen (%20
) gefolgt von asc
oder desc
hinzu, um die aufsteigende oder absteigende Reihenfolge festzulegen. Beispiel:
GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
- Die Kanalsortierung erfolgt in der folgenden Reihenfolge:
stable
,beta
,dev
,canary
,canary_asan
. - Das Sortieren nach
name
kann zu unerwartetem Verhalten führen, da es sich um eine einfache Stringsortierung handelt. Beispiel:1.0.0.8
liegt in absteigender Reihenfolge vor 1.0.0.10. - Wenn
order_by
nicht angegeben ist, erfolgt die Standardsortierung nachplatform
,channel
,version
und dannserving.starttime
.