Referencia de la API de VersionHistory

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

Todos los accesos de las APIs se realizan mediante HTTPS, y se puede acceder a ellos desde https://versionhistory.googleapis.com/v1.

Versión

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

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.

Lanzamiento

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

Obtener todas las versiones

Enumera todas las versiones 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 Un identificador de versión.

Producto

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

Identificadores de productos

Descripción Valor
Chrome chrome
Fuchsia Web Engine fuchsiawebengine

Plataforma

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

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 utilizar? para obtener una explicación de los canales de Chrome.

Obtener los canales válidos de una plataforma

Enumera 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 de versión y actualización 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* y fraction*
Operador <, <=, =, >, >=
  • El filtrado de canales se realiza por distancia desde el canal 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 está escrita por completo, VersionHistory agrega 0 para los campos faltantes. Por ejemplo, version>80 se convierte en version>80.0.0.0.
  • endtime=none filtra las versiones que están publicadas y que aún no tienen una hora de finalización.
  • Cuando filtras por starttime o endtime, el valor debe estar en formato de string de fecha RFC 3339.
  • name y platform se filtran por comparación de strings.
  • No se propagará serving.endtime en las versiones que todavía se publiquen en Chrome. Durante el ordenamiento o el filtrado, serving.endtime se tratará como 1970-01-01T00:00:00Z si el campo no se propaga.
  • fraction se usa para especificar cuántos usuarios participaron en el lanzamiento. Por ejemplo, fraction=1 significa el 100% de los usuarios.

Ordenar resultados

Agrega un parámetro de consulta order_by para ordenar los resultados. Solo los extremos de versión y lanzamiento admiten pedidos. 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 causar un comportamiento inesperado, ya que se trata de un ordenamiento de strings simple. Por ejemplo, 1.0.0.8 estará antes de 1.0.0.10 en orden descendente.
  • Cuando no se especifica order_by, el orden predeterminado es mediante platform, channel, version y, luego, serving.starttime.