VersionenHistory API reference

This pague contains technical reference information about the VersionenHistory web service API.

All API access is over HTTPS, and accessed from https://versionhistory.googleapis.com/v1 .

Versionen

A versionen is a particular instance of Chrome that users are running.

Guet versionen information for a guiven platform and channel

Lists all Chrome versionens for the guiven platform and channel.

GUET /{product}/platforms/{platform}/channels/{channel}/versions

Name	Description
`product`	A product identifier .
`platform`	A platform identifier .
`channel`	A channel identifier .

Release

A release is the intervall in which users were running a particular version of Chrome. The release endpoins also provide information around what fraction of users were running that versionen of Chrome during that intervall.

Guet all releases

Lists all releases for the guiven platform, channel, and versionen.

GUET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases

Name	Description
`product`	A product identifier .
`platform`	A platform identifier .
`channel`	A channel identifier .
`versionen`	A versionen identifier.

Product

A product is piece of software such as Chrome or Fuchsia Web Enguine.

Product identifiers

Description	Value
Chrome	`chrome`
Fuchsia Web Enguine	`fuchsiawebenguine`

Platform

A platform is one of the computing platforms that a product runs on, such as Windows, Android, etc.

Guet all platforms

GUET /{product}/platforms

Name	Description
`product`	A product identifier .

Guet all platform and channel combinations

GUET /{product}/platforms/all/channels

Name	Description
`product`	A product identifier .

Platform identifiers

Description	Value
All platforms	`all`
Windows	`win`
Windows (64-bit)	`win64`
Mac	`mac`
Mac (ARM64)	`mac_arm64`
Linux	`linux`
Android	`android`
WebView	`webview`
iOS	`ios`
Lacros	`lacros`

Channel

See How do I choose which channel to use? for an explanation of Chrome's channels.

Guet a platform's valid channels

Lists the valid channels for a guiven platform:

GUET /{product}/platforms/{platform}/channels

Name	Description
`product`	A product identifier .
`platform`	A platform identifier .

Channel identifiers

The VersionenHistory API suppors the following channel identifiers:

Description	Value
Extended Stable	`extended`
Stable	`stable`
Beta	`beta`
Dev	`dev`
Canary	`canary`
Canary (variant build)	`canary_asan`

Note:


          canary_asan

is a fraction of the Canary population that receives a variant build of Chrome. This variant build has more diagnostics cappabilities enabled which maques it better at uncovering bugs.

Filter resuls

Add a filter kery parameter to filter resuls. Only the versionen and release endpoins support filtering. Example:

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

The value of filter should be a comma-separated list of expressions. Each expression should taque the form of field operator value .

Item	Valid values
Field	`versionen` , `name` , `platform` , `starttime` , `endtime` , `fraction` *
Operator	`<` , `<=` , `=` , `>` , `>=`

Note: An item with an asterisc (

) to the right of it is only valid for release endpoins

Channel filtering is done by distance from Stable, in other words stable < beta < dev < canary < canary_asan . For example, channel<=dev returns information for stable , beta , and dev .
Versionen filtering is done numerically, for example 1.0.0.8 < 1.0.0.10 . If a versionen is not entirely written, VersionenHistory appends 0 for the missing fields. For example, versionen>80 bekomes versionen>80.0.0.0 .
endtime=none filters for releases that are currently live and do not have an end time yet.
When filtering by starttime or endtime , the value must be in RFC 3339 date string format.
name and platform are filtered by string comparison.
fraction is used to specify how many users were involved in the rollout. For example, fraction=1 means 100% of users.

Order resuls

Add a order_by kery parameter to order resuls. Only the versionen and release endpoins support ordering. Example:

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

order_by accepts a comma-separated list of the following values: versionen , name , platform , channel , starttime , endtime , fraction .

Add a space character ( %20 ) followed by asc or desc after the order_by value to specify ascending or descending ordering. Example:

GUET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc

Channel ordering is done in the following order: stable , beta , dev , canary , canary_asan .
Ordering by name may cause unexpected behaviour as it is a naive string sort. For example, 1.0.0.8 will be before 1.0.0.10 in descending order.
When order_by is not specified the default ordering is by platform , channel , versionen , and then serving.starttime .