Referenz zur VersionHistory API

Diese Seite enthält technische Referenzinformationen zur VersionVerlauf-Webdienst-API.

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

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 jeweilige Plattform und den angegebenen Kanal auf.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Name Beschreibung
product Eine Produktkennzeichnung.
platform Eine Plattformkennung.
channel Eine Kanalkennung.

Release

Ein Release ist das Intervall, in dem Nutzer eine bestimmte Version von Chrome ausgeführt haben. Die Release-Endpunkte liefern auch Informationen dazu, welcher Anteil der Nutzer in diesem Zeitraum die jeweilige Chrome-Version ausgeführt hat.

Alle Releases abrufen

Listet alle Releases für die jeweilige 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 Plattformkennung.
channel Eine Kanalkennung.
version Eine Versions-ID.

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, Android usw.

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

Informationen zu den verfügbaren Chrome-Versionen finden Sie unter Wie wähle ich die richtige Version aus?.

Gültige Channels einer Plattform abrufen

Listet die gültigen Channels für eine bestimmte Plattform auf:

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

Kanalkennungen

Die Version History API unterstützt die folgenden Kanalkennungen:

Beschreibung Wert
Erweiterte stabile 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 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 sollte eine durch Kommas getrennte Liste von Ausdrücken sein. Jeder Ausdruck muss das Format field operator value haben.

Artikel Zulässige Werte
Field version, name, platform, starttime*, endtime*, fraction*
Operator <, <=, =, >, >=
  • Der Kanal wird nach der Entfernung zur stabilen Version gefiltert, d. h. stable < beta < dev < canary < canary_asan. Zum Beispiel gibt channel<=dev 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 VersionVerlauf für die fehlenden Felder 0 an. Aus version>80 wird beispielsweise version>80.0.0.0.
  • endtime=none filtert nach Releases, die derzeit live sind und noch kein Ende haben.
  • Wenn Sie nach starttime oder endtime filtern, muss der Wert im Datumsstringformat RFC 3339 vorliegen.
  • name und platform werden durch Stringvergleich gefiltert.
  • Bei Releases, die noch von Chrome bereitgestellt werden, wird serving.endtime nicht ausgefüllt. Beim Sortieren oder Filtern wird serving.endtime als 1970-01-01T00:00:00Z behandelt, wenn das Feld nicht ausgefüllt ist.
  • Mit fraction wird angegeben, wie viele Nutzer am Roll-out beteiligt waren. fraction=1 bedeutet beispielsweise 100% der Nutzer.

Bestellergebnisse

Fügen Sie einen order_by-Abfrageparameter hinzu, um die Ergebnisse zu sortieren. Die Sortierung wird nur von den Versions- und Release-Endpunkten unterstützt. 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 ein Leerzeichen (%20) gefolgt von asc oder desc nach dem Wert order_by ein, um auf- oder absteigend zu sortieren. 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.
  • Die Sortierung nach name kann zu unerwartetem Verhalten führen, da es sich um eine naive Zeichenfolgensortierung handelt. Zum Beispiel liegt 1.0.0.8 vor 1.0.0.10 in absteigender Reihenfolge.
  • Wenn order_by nicht angegeben ist, gilt die Standardsortierung nach platform, channel, version und dann nach serving.starttime.