Referenz zur VersionHistory API

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 zu stable, beta und dev 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 Felder 0 an. Aus version>80 wird dann beispielsweise version>80.0.0.0.
  • endtime=none filtert nach Releases, die derzeit live sind und noch kein Ende haben.
  • Beim Filtern nach starttime oder endtime muss der Wert im Datumsstringformat RFC 3339 vorliegen.
  • name und platform werden durch Stringvergleich gefiltert.
  • Für Releases, die noch von Chrome bereitgestellt werden, wird serving.endtime nicht ausgefüllt. Beim Sortieren oder Filtern wird serving.endtime wie 1970-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 nach platform, channel, version und dann serving.starttime.