Referenz zur VersionHistory API

Diese Seite enthält technische Referenzinformationen zur VersionHistory Webservice API.

Der gesamte API-Zugriff erfolgt über HTTPS und von https://versionhistory.googleapis.com/v1 aus.

Version

Eine Version ist eine bestimmte Instanz von Chrome, die Nutzer ausführen.

Versionsinformationen für eine bestimmte Plattform und einen bestimmten Kanal abrufen

Listet alle Chrome-Versionen für die angegebene Plattform und den angegebenen Kanal auf.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Name Beschreibung
product Eine Produktkennzeichnung.
platform Eine Plattform-ID.
channel Eine Kanal-ID.

Release

Eine Version ist der Zeitraum, in dem Nutzer eine bestimmte Version von Chrome verwendet haben. Die Release-Endpunkte enthalten auch Informationen dazu, welcher Anteil der Nutzer diese Version von Chrome in diesem Intervall verwendet hat.

Alle Releases abrufen

Listet alle Releases für die angegebene Plattform, den Kanal und die 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 die Fuchsia Web Engine.

Produkt-IDs

Beschreibung Wert
Chrome chrome
Fuchsia Web Engine fuchsiawebengine

Plattform

Eine Plattform ist eine der Computing-Plattformen, auf denen ein Produkt ausgeführt wird, z. B. Windows oder Android.

Alle Plattformen abrufen

GET /{product}/platforms
Name Beschreibung
product Eine Produktkennzeichnung.

Alle Kombinationen aus Plattform und Kanal abrufen

GET /{product}/platforms/all/channels
Name Beschreibung
product Eine Produktkennzeichnung.

Plattform-IDs

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 Erklärung zu den Chrome-Versionen finden Sie unter Welche Version von Chrome soll ich verwenden?

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 Kanal-IDs:

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 die Ergebnisse zu filtern. Nur die Endpunkte version und release unterstützen das Filtern. Beispiel:

GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1

Der Wert von filter muss 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*
Operator <, <=, =, >, >=
  • Die Kanalfilterung erfolgt nach der Entfernung von der Stable-Version, d. h. stable < beta < dev < canary < canary_asan. Beispiel: channel<=dev gibt Informationen für 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, wird in „VersionHistory“ 0 für die fehlenden Felder angehängt. Aus version>80 wird beispielsweise version>80.0.0.0.
  • endtime=none Filter für Releases, die derzeit live sind und noch kein Enddatum haben.
  • Wenn nach starttime oder endtime gefiltert wird, muss der Wert im Datumsstringformat RFC 3339 angegeben sein.
  • name und platform werden durch Stringvergleich gefiltert.
  • Mit fraction wird angegeben, wie viele Nutzer am Roll-out beteiligt waren. fraction=1 steht beispielsweise für 100% der Nutzer.

Ergebnisse sortieren

Fügen Sie einen order_by-Abfrageparameter 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

Für order_by ist eine kommagetrennte Liste der folgenden Werte zulässig: version, name, platform, channel, starttime, endtime und fraction.

Fügen Sie nach dem order_by-Wert ein Leerzeichen (%20) gefolgt von asc oder desc hinzu, um eine aufsteigende oder absteigende Sortierung anzugeben. Beispiel:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Die Kanalreihenfolge ist: stable, beta, dev, canary, canary_asan.
  • Die Sortierung nach name kann zu unerwartetem Verhalten führen, da es sich um eine naive Stringsortierung handelt. Beispielsweise wird 1.0.0.8 in absteigender Reihenfolge vor 1.0.0.10 angezeigt.
  • Wenn order_by nicht angegeben ist, erfolgt die Standardsortierung nach platform, channel, version und dann serving.starttime.