VersionHistory API-referentie

Deze pagina bevat technische referentie-informatie over de VersionHistory-webservice-API.

Alle API-toegang verloopt via HTTPS en is toegankelijk via https://versionhistory.googleapis.com/v1 .

Versie

Een versie is een specifiek exemplaar van Chrome dat gebruikers gebruiken.

Ontvang versie-informatie voor een bepaald platform en kanaal

Geeft een overzicht van alle Chrome-versies voor het opgegeven platform en kanaal.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Naam Beschrijving
product Een product-ID .
platform Een platform-ID .
channel Een kanaalidentificatie .

Uitgave

Een release is het interval waarin gebruikers een bepaalde versie van Chrome gebruikten. De release-eindpunten bieden ook informatie over welk deel van de gebruikers tijdens dat interval die versie van Chrome gebruikte.

Ontvang alle releases

Geeft een overzicht van alle releases voor het betreffende platform, kanaal en versie.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Naam Beschrijving
product Een product-ID .
platform Een platform-ID .
channel Een kanaalidentificatie .
version Een versie-ID.

Product

Een product is een stukje software zoals Chrome of Fuchsia Web Engine.

Product-ID's

Beschrijving Waarde
Chroom chrome
Fuchsia webengine fuchsiawebengine

Platform

Een platform is een van de computerplatforms waarop een product draait, zoals Windows, Android, enz.

Verkrijg alle platforms

GET /{product}/platforms
Naam Beschrijving
product Een product-ID .

Ontvang alle platform- en kanaalcombinaties

GET /{product}/platforms/all/channels
Naam Beschrijving
product Een product-ID .

Platform-ID's

Beschrijving Waarde
Alle platforms all
Ramen win
Windows (64-bits) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
Webweergave webview
iOS ios
Lacros lacros

Kanaal

Zie Hoe kies ik welk kanaal ik wil gebruiken? voor uitleg over de kanalen van Chrome.

Ontvang de geldige kanalen van een platform

Geeft een overzicht van de geldige kanalen voor een bepaald platform:

GET /{product}/platforms/{platform}/channels
Naam Beschrijving
product Een product-ID .
platform Een platform-ID .

Kanaal-ID's

De VersionHistory API ondersteunt de volgende kanaal-ID's:

Beschrijving Waarde
Uitgebreide stal extended
Stabiel stable
Bèta beta
Ontwikkelaar dev
Kanarie canary
Kanarie (variant gebouwd) canary_asan

Resultaten filteren

Voeg een filter toe om de resultaten te filteren. Alleen de versie- en release- eindpunten ondersteunen filteren. Voorbeeld:

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

De waarde van filter moet een door komma's gescheiden lijst met expressies zijn. Elke expressie moet de vorm aannemen van field operator value .

Item Geldige waarden
Veld version , name , platform , starttime *, endtime *, fraction *
Exploitant < , <= , = , > , >=
  • Kanaalfiltering gebeurt op afstand van Stabiel, met andere woorden stable < beta < dev < canary < canary_asan . channel<=dev retourneert bijvoorbeeld informatie voor stable , beta en dev .
  • Versiefiltering gebeurt numeriek, bijvoorbeeld 1.0.0.8 < 1.0.0.10 . Als een versie niet volledig is geschreven, voegt VersionHistory 0 toe voor de ontbrekende velden. version>80 wordt bijvoorbeeld version>80.0.0.0 .
  • endtime=none filtert op releases die momenteel live zijn en nog geen eindtijd hebben.
  • Bij het filteren op starttime of endtime moet de waarde de RFC 3339- datumtekenreeksnotatie hebben.
  • name en platform worden gefilterd door stringvergelijking.
  • Voor releases die Chrome nog steeds levert, wordt serving.endtime niet ingevuld. Tijdens het bestellen of filteren wordt serving.endtime behandeld als 1970-01-01T00:00:00Z als het veld niet is ingevuld.
  • fraction wordt gebruikt om aan te geven hoeveel gebruikers bij de uitrol betrokken waren. fraction=1 betekent bijvoorbeeld 100% van de gebruikers.

Resultaten bestellen

Voeg een order_by -queryparameter toe om de resultaten te ordenen. Alleen de versie- en release- eindpunten ondersteunen bestellingen. Voorbeeld:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime

order_by accepteert een door komma's gescheiden lijst met de volgende waarden: version , name , platform , channel , starttime , endtime , fraction .

Voeg een spatie ( %20 ) toe, gevolgd door asc of desc na de waarde order_by om een ​​oplopende of aflopende volgorde op te geven. Voorbeeld:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • Het ordenen van kanalen gebeurt in de volgende volgorde: stable , beta , dev , canary , canary_asan .
  • Sorteren op name kan onverwacht gedrag veroorzaken, omdat het een naïeve tekenreekssortering is. 1.0.0.8 komt bijvoorbeeld vóór 1.0.0.10 in aflopende volgorde.
  • Als order_by niet is opgegeven, is de standaardvolgorde per platform , channel , version en vervolgens serving.starttime .