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 parastable
,beta
ydev
. - 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 agrega0
para los campos faltantes. Por ejemplo,version>80
se convierte enversion>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
oendtime
, el valor debe estar en formato de string de fecha RFC 3339. name
yplatform
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á como1970-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
ycanary_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 medianteplatform
,channel
,version
y, luego,serving.starttime
.