Referência da API VersionHistory

Esta página contém informações de referência técnica sobre a API 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 executam.

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

Lista todas as versões do Chrome da plataforma e do canal especificados.

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

Lançar

Uma versão é o intervalo em que os usuários estavam executando 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 estava executando essa versão do Chrome durante esse intervalo.

Acessar todos os lançamentos

Lista todos os lançamentos de cada plataforma, canal e versão.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Nome Descrição
product Um identificador do produto.
platform Um identificador da plataforma.
channel Um identificador do 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
Mecanismo da Web Fuchsia fuchsiawebengine

Plataforma

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

Acesse todas as plataformas

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

Confira todas as combinações de plataforma e canal

GET /{product}/platforms/all/channels
Nome Descrição
product Um identificador do 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 escolho qual canal usar? para ver uma explicação sobre os canais do Chrome.

Receber 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 do produto.
platform Um identificador da plataforma.

Identificadores de canais

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

Descrição Valor
Estável estendido extended
Estável stable
Beta beta
Dev dev
Canary canary
Canário (build variante) canary_asan

Filtrar resultados

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

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

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

Item Valores válidos
Campo version, name, platform, starttime*, endtime* e fraction*
Operador <, <=, =, >, >=
  • A filtragem de canais é feita pela distância do Canal Stable, ou seja, stable < beta < dev < canary < canary_asan. Por exemplo, channel<=dev retorna informações para stable, beta e dev.
  • A filtragem da versão é feita numericamente, por exemplo, 1.0.0.8 < 1.0.0.10. Se uma versão não tiver sido totalmente gravada, o VersionHistory anexará 0 para os campos ausentes. Por exemplo, version>80 se torna version>80.0.0.0.
  • endtime=none filtra as versões que estão ativas 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.
  • Nas versões em que o Chrome ainda estiver sendo veiculado, o serving.endtime não será preenchido. Durante a classificação ou a 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 estavam envolvidos no lançamento. Por exemplo, fraction=1 significa 100% dos usuários.

Resultados do pedido

Adicione um parâmetro de consulta order_by para ordenar os resultados. Somente os endpoints de versão e lançamento aceitam ordem. Exemplos

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, fraction.

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

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