Referência da API VersionHistory

Esta página contém informações de referência técnica sobre a API do serviço da Web VersionHistory.

Todo o acesso à API é feito por HTTPS e acessado em https://versionhistory.googleapis.com/v1.

Versão

Uma versão é uma instância específica do Chrome que os usuários estão executando.

Receber informações de versão para uma determinada plataforma e canal

Lista todas as versões do Chrome para a plataforma e o canal especificados.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Nome Descrição
product Um identificador de produto.
platform Um identificador de plataforma.
channel Um identificador de canal.

Versão

Uma versão é o intervalo em que os usuários executam uma versão específica do Chrome. Os endpoints de lançamento também fornecem informações sobre a fração de usuários que usavam essa versão do Chrome durante esse intervalo.

Acessar todas as versões

Lista todos os lançamentos para a plataforma, o canal e a versão.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Nome Descrição
product Um identificador de produto.
platform Um identificador de plataforma.
channel Um identificador de canal.
version Um identificador de versão.

Produto

Um produto é um software, como o Chrome ou o Fuchsia Web Engine.

Identificadores de produto

Descrição Valor
Chrome chrome
Fuchsia Web Engine fuchsiawebengine

Plataforma

Uma plataforma é uma das plataformas de computação em que um produto é executado, como Windows, Android etc.

Acessar todas as plataformas

GET /{product}/platforms
Nome Descrição
product Um identificador de produto.

Receber todas as combinações de plataforma e canal

GET /{product}/platforms/all/channels
Nome Descrição
product Um identificador de produto.

Identificadores de plataforma

Descrição Valor
Todas as 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

Consulte Como escolher qual canal usar? para uma explicação dos canais do Chrome.

Conferir os canais válidos de uma plataforma

Lista os canais válidos para uma determinada plataforma:

GET /{product}/platforms/{platform}/channels
Nome Descrição
product Um identificador de produto.
platform Um identificador de plataforma.

Identificadores de canal

A API VersionHistory é compatível com os seguintes identificadores de canal:

Descrição Valor
Extended Stable extended
Estável stable
Beta beta
Dev dev
Canary canary
Canary (build de variante) canary_asan

Filtrar resultados

Adicione um parâmetro de consulta filter para filtrar os resultados. Somente os endpoints version e release são compatíveis com a filtragem. Exemplo:

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

O valor de filter precisa ser uma lista de expressões separadas por vírgulas. Cada expressão precisa ter o formato field operator value.

Item Valores válidos
Campo version, name, platform, starttime*, endtime*, fraction*
Operador <, <=, =, >, >=
  • A filtragem de canais é feita pela distância da versão estável, ou seja, stable < beta < dev < canary < canary_asan. Por exemplo, channel<=dev retorna informações para stable, beta e dev.
  • A filtragem de versões é feita numericamente, por exemplo, 1.0.0.8 < 1.0.0.10. Se uma versão não for totalmente gravada, o VersionHistory vai anexar 0 aos campos ausentes. Por exemplo, version>80 se torna version>80.0.0.0.
  • Os filtros endtime=none são para lançamentos que estão ativos e ainda não têm um horário de término.
  • Ao filtrar por starttime ou endtime, o valor precisa estar no formato de string de data RFC 3339.
  • name e platform são filtrados por comparação de string.
  • Para as versões que o Chrome ainda está veiculando, serving.endtime não será preenchido. Durante a ordenação ou filtragem, serving.endtime será tratado como 1970-01-01T00:00:00Z se o campo não for preenchido.
  • fraction é usado para especificar quantos usuários estiveram envolvidos no lançamento. Por exemplo, fraction=1 significa 100% dos usuários.

Ordenar resultados

Adicione um parâmetro de consulta order_by para ordenar os resultados. Somente os endpoints version e release são compatíveis com o pedido. Exemplo:

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

order_by aceita uma lista separada por vírgulas dos seguintes valores: version, name, platform, channel, starttime, endtime e fraction.

Adicione um caractere de espaço (%20) seguido por asc ou desc após o valor order_by para especificar a ordem crescente ou decrescente. Exemplo:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • A ordenação do canal é feita na seguinte ordem: stable, beta, dev, canary e canary_asan.
  • A ordenação por name pode causar um comportamento inesperado, já que é uma ordenação de string simples. Por exemplo, 1.0.0.8 vai estar antes de 1.0.0.10 em ordem decrescente.
  • Quando order_by não é especificado, a ordem padrão é platform, channel, version e serving.starttime.