Cette page contient des informations techniques de référence sur l'API de service Web VersionHistory.
Tous les accès aux API se font via HTTPS et sont accessibles depuis https://versionhistory.googleapis.com/v1
.
Version
Une version est une instance particulière de Chrome exécutée par les utilisateurs.
Obtenir les informations de version pour une plate-forme et un canal donnés
Liste toutes les versions de Chrome pour la plate-forme et la version données.
GET /{product}/platforms/{platform}/channels/{channel}/versions
Nom | Description |
---|---|
product |
Un code produit. |
platform |
Un identifiant de plate-forme. |
channel |
Un identifiant de chaîne. |
Publier
Une version correspond à l'intervalle pendant lequel les utilisateurs exécutaient une version particulière de Chrome. Les points de terminaison de version fournissent également des informations sur la proportion d'utilisateurs exécutant cette version de Chrome au cours de cet intervalle.
Télécharger toutes les versions
Liste toutes les versions pour la plate-forme, le canal et la version donnés.
GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Nom | Description |
---|---|
product |
Un code produit. |
platform |
Un identifiant de plate-forme. |
channel |
Un identifiant de chaîne. |
version |
Identifiant de version. |
Produit
Un produit est un logiciel tel que Chrome ou le moteur Web Fuchsia.
Codes produit
Description | Valeur |
---|---|
Chrome | chrome |
Moteur Web Fuchsia | fuchsiawebengine |
Plate-forme
Une plate-forme est l'une des plates-formes informatiques sur lesquelles un produit s'exécute, telles que Windows, Android, etc.
Télécharger toutes les plates-formes
GET /{product}/platforms
Nom | Description |
---|---|
product |
Un code produit. |
Obtenir toutes les combinaisons de plates-formes et de chaînes
GET /{product}/platforms/all/channels
Nom | Description |
---|---|
product |
Un code produit. |
Identifiants de plate-forme
Description | Valeur |
---|---|
Toutes les plates-formes | all |
Windows | win |
Windows (64 bits) | win64 |
Mac | mac |
Mac (ARM64) | mac_arm64 |
Linux | linux |
Android | android |
WebView | webview |
iOS | ios |
Lacros | lacros |
Chaîne
Consultez la section Comment choisir la version à utiliser ? pour obtenir des explications sur les versions de Chrome.
Obtenir les chaînes valides d'une plate-forme
Liste les canaux valides pour une plate-forme donnée:
GET /{product}/platforms/{platform}/channels
Nom | Description |
---|---|
product |
Un code produit. |
platform |
Un identifiant de plate-forme. |
Identifiants des canaux
L'API VersionHistory accepte les identifiants de canal suivants:
Description | Valeur |
---|---|
Version stable étendue | extended |
Stable | stable |
Bêta | beta |
Dév | dev |
Canary | canary |
Canary (création de variantes) | canary_asan |
Filtrer les résultats
Ajoutez un paramètre de requête filter
pour filtrer les résultats. Seuls les points de terminaison version et version sont compatibles avec le filtrage.
Exemple :
GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1
La valeur de filter
doit être une liste d'expressions séparées par une virgule. Chaque expression doit prendre la forme field operator value
.
Article | Valeurs valides |
---|---|
Champ |
version , name , platform ,
starttime *, endtime *, fraction *
|
Opérateur |
< , <= , = , > , >=
|
- Le filtrage des canaux s'effectue en fonction de la distance par rapport à la version stable, c'est-à-dire
stable
<beta
<dev
<canary
<canary_asan
. Par exemple,channel<=dev
renvoie des informations pourstable
,beta
etdev
. - Le filtrage des versions est effectué de manière numérique, par exemple
1.0.0.8
<1.0.0.10
. Si une version n'est pas entièrement écrite, l'historique des versions ajoute0
pour les champs manquants. Par exemple,version>80
devientversion>80.0.0.0
. endtime=none
filtre les versions qui sont actuellement en ligne et qui n'ont pas encore d'heure de fin.- Lors du filtrage par
starttime
ouendtime
, la valeur doit être au format de chaîne de date RFC 3339. name
etplatform
sont filtrés par comparaison de chaînes.- Pour les versions que Chrome est toujours en cours de diffusion,
serving.endtime
ne sera pas renseigné. Lors du tri ou du filtrage,serving.endtime
est traité comme1970-01-01T00:00:00Z
si le champ n'est pas renseigné. fraction
permet d'indiquer le nombre d'utilisateurs ayant participé au déploiement. Par exemple,fraction=1
signifie 100% des utilisateurs.
Classer les résultats
Ajoutez un paramètre de requête order_by
pour classer les résultats. Seuls les points de terminaison version et release peuvent être classés.
Exemple :
GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime
order_by
accepte une liste des valeurs suivantes séparées par une virgule: version
, name
, platform
, channel
, starttime
, endtime
, fraction
.
Ajoutez un espace (%20
) suivi de asc
ou desc
après la valeur order_by
pour indiquer l'ordre croissant ou décroissant. Exemple :
GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
- L'ordre des canaux est effectué dans l'ordre suivant:
stable
,beta
,dev
,canary
,canary_asan
. - Le tri par
name
peut entraîner un comportement inattendu, car il s'agit d'un tri de chaîne naïf. Par exemple,1.0.0.8
sera antérieur à 1.0.0.10 dans l'ordre décroissant. - Si
order_by
n'est pas spécifié, l'ordre par défaut estplatform
,channel
,version
, puisserving.starttime
.