Referencia de la API de VersionHistory

Esta página contiene información de referencia técnica sobre la API del servicio web de VersionHistory.

Todo el acceso a la API se realiza a través de HTTPS y se accede a él desde https://versionhistory.googleapis.com/v1.

Versión

Una versión es una instancia particular de Chrome que ejecutan los usuarios.

Cómo obtener información de la versión de una plataforma y un canal determinados

Muestra una lista de todas las versiones de Chrome para la plataforma y el canal determinados.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Nombre Descripción
product Un identificador de producto.
platform Un identificador de plataforma
channel Un identificador de canal

Versión

Una versión es el intervalo en el que los usuarios ejecutaban una versión particular de Chrome. Los extremos de lanzamiento también proporcionan información sobre qué fracción de usuarios ejecutaba esa versión de Chrome durante ese intervalo.

Cómo obtener todas las versiones

Muestra una lista de todos los lanzamientos de la plataforma, el canal y la versión determinados.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Nombre Descripción
product Un identificador de producto.
platform Un identificador de plataforma
channel Un identificador de canal
version Es un identificador de versión.

Producto

Un producto es un software, como Chrome o Fuchsia Web Engine.

Identificadores de productos

Descripción Valor
Chrome chrome
Motor web de Fuchsia fuchsiawebengine

Plataforma

Una plataforma es una de las plataformas de procesamiento en las que se ejecuta un producto, como Windows, Android, etcétera.

Cómo obtener todas las plataformas

GET /{product}/platforms
Nombre Descripción
product Un identificador de producto.

Obtén todas las combinaciones de plataformas y canales

GET /{product}/platforms/all/channels
Nombre Descripción
product Un identificador de producto.

Identificadores de plataforma

Descripción Valor
Todas las plataformas all
Windows win
Windows (64 bits) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Lacros lacros

Canal

Consulta ¿Cómo elijo qué canal usar? para obtener una explicación de los canales de Chrome.

Obtén los canales válidos de una plataforma

Muestra una lista de los canales válidos para una plataforma determinada:

GET /{product}/platforms/{platform}/channels
Nombre Descripción
product Un identificador de producto.
platform Un identificador de plataforma

Identificadores de canales

La API de VersionHistory admite los siguientes identificadores de canal:

Descripción Valor
Estable extendido extended
Estable stable
Beta beta
Desarrollo dev
Canary canary
Canary (compilación de variante) canary_asan

Filtrar resultados

Agrega un parámetro de consulta filter para filtrar los resultados. Solo los extremos version y release admiten el filtrado. Ejemplo:

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

El valor de filter debe ser una lista de expresiones separadas por comas. Cada expresión debe tener el formato field operator value.

Elemento Valores válidos
Campo version, name, platform, starttime*, endtime*, fraction*
Operador <, <=, =, >, >=
  • El filtrado de canales se realiza según la distancia desde la versión estable, es decir, stable < beta < dev < canary < canary_asan. Por ejemplo, channel<=dev muestra información para stable, beta y dev.
  • El filtrado de versiones se realiza de forma numérica, por ejemplo, 1.0.0.8 < 1.0.0.10. Si una versión no se escribe por completo, VersionHistory agrega 0 para los campos que faltan. Por ejemplo, version>80 se convierte en version>80.0.0.0.
  • endtime=none filtra las versiones que están publicadas actualmente y aún no tienen una hora de finalización.
  • Cuando filtres por starttime o endtime, el valor debe estar en formato de cadena de fecha RFC 3339.
  • name y platform se filtran por comparación de cadenas.
  • fraction se usa para especificar cuántos usuarios participaron en el lanzamiento. Por ejemplo, fraction=1 significa el 100% de los usuarios.

Ordena los resultados

Agrega un parámetro de consulta order_by para ordenar los resultados. Solo los extremos version y release admiten el ordenamiento. Ejemplo:

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

order_by acepta una lista separada por comas de los siguientes valores: version, name, platform, channel, starttime, endtime, fraction.

Agrega un carácter de espacio (%20) seguido de asc o desc después del valor order_by para especificar el orden ascendente o descendente. Ejemplo:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • El orden de los canales se realiza en el siguiente orden: stable, beta, dev, canary y canary_asan.
  • El orden por name puede provocar un comportamiento inesperado, ya que es una ordenación de cadenas ingenua. Por ejemplo, 1.0.0.8 estará antes que 1.0.0.10 en orden descendente.
  • Cuando no se especifica order_by, el orden predeterminado es platform, channel, version y, luego, serving.starttime.