Documentation de référence de l'API VersionHistory

Cette page contient des informations de référence techniques sur l'API du service Web VersionHistory.

Tout accès à l'API s'effectue via HTTPS et à partir de https://versionhistory.googleapis.com/v1.

Version

Une version est une instance particulière de Chrome que les utilisateurs exécutent.

Obtenir des informations sur la version pour une plate-forme et une chaîne données

Répertorie toutes les versions de Chrome pour la plate-forme et le canal donnés.

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.

Version

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 fraction d'utilisateurs qui exécutaient cette version de Chrome au cours de cet intervalle.

Obtenir toutes les versions

Répertorie toutes les versions pour la plate-forme, la chaîne et la version données.

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, comme Chrome ou Fuchsia Web Engine.

Codes produit

Description Valeur
Chrome chrome
Moteur Web Fuchsia fuchsiawebengine

Plate-forme

Une plate-forme est l'une des plates-formes de calcul sur lesquelles s'exécute un produit, comme Windows, Android, etc.

Obtenir toutes les plates-formes

GET /{product}/platforms
Nom Description
product Un code produit.

Obtenir toutes les combinaisons de plates-formes et de canaux

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

Pour en savoir plus sur les canaux Chrome, consultez Comment choisir le canal à utiliser ?

Obtenir les chaînes valides d'une plate-forme

Répertorie 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 de canal

L'API VersionHistory est compatible avec les identifiants de canaux suivants:

Description Valeur
Stable étendu extended
Stable stable
Bêta beta
Dév dev
Canary canary
Canary (build de variante) 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 release 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 se présenter sous la forme field operator value.

Élément Valeurs valides
Champ version, name, platform, starttime*, endtime*, fraction*
Opérateur <, <=, =, >, >=
  • Le filtrage des canaux est effectué 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 pour stable, beta et dev.
  • 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, VersionHistory ajoute 0 pour les champs manquants. Par exemple, version>80 devient version>80.0.0.0.
  • endtime=none filtre les versions actuellement en ligne et qui n'ont pas encore d'heure de fin.
  • Lorsque vous filtrez par starttime ou endtime, la valeur doit être au format de chaîne de date RFC 3339.
  • name et platform sont filtrés par comparaison de chaînes.
  • Pour les versions que Chrome diffuse toujours, serving.endtime ne sera pas renseigné. Lors de l'ordre ou du filtrage, serving.endtime sera traité comme 1970-01-01T00:00:00Z si le champ n'est pas renseigné.
  • fraction permet de spécifier le nombre d'utilisateurs impliqués dans le déploiement. Par exemple, fraction=1 signifie 100% des utilisateurs.

Classer les résultats

Ajoutez un paramètre de requête order_by pour trier les résultats. Seuls les points de terminaison version et release sont compatibles avec la commande d'ordre. 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 et fraction.

Ajoutez un caractère espace (%20) suivi de asc ou desc après la valeur order_by pour spécifier un tri croissant ou décroissant. Exemple :

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • L'ordre des canaux est le suivant: stable, beta, dev, canary et canary_asan.
  • L'ordre 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 avant 1.0.0.10 par ordre décroissant.
  • Lorsque order_by n'est pas spécifié, l'ordre par défaut est platform, channel, version, puis serving.starttime.