Referencia de la API de VersionHistory

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

Todo el acceso a la API se realiza a través de HTTPS y se accede 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 para 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 en particular de Chrome. Los extremos de actualización también proporcionan información sobre qué fracción de usuarios ejecutaban 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 una pieza 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.

Obtener todas las combinaciones de plataforma y canal

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

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 canal

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 versión son compatibles con 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 la forma de field operator value.

Elemento Valores válidos
Campo version, name, platform, starttime*, endtime* y fraction*
Operador <, <=, =, >, >=
  • El filtrado de canales se realiza por la distancia desde el canal estable, en otras palabras, 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 para las versiones que están publicadas y aún no tienen una hora de finalización.
  • Cuando filtras 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 strings.
  • En el caso de las versiones que Chrome sigue publicando, no se propagará serving.endtime. 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 representa el 100% de los usuarios.

Resultados del pedido

Agrega un parámetro de consulta order_by para ordenar los resultados. Solo los extremos de versión y versión 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 y 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 ordenamiento por name puede causar un comportamiento inesperado, ya que es un orden simple de string. Por ejemplo, 1.0.0.8 será anterior a 1.0.0.10 en orden descendente.
  • Cuando no se especifica order_by, el orden predeterminado es platform, channel, version y, luego, serving.starttime.