Referência da API VersionHistory

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

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

Versão

Uma versão é uma instância específica do Chrome executada pelos usuários.

Acessar informações da 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 de plataforma.
channel Um identificador do canal.

Lançar

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

Conferir todos os lançamentos

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

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

Acessar 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 escolher qual canal usar? para uma explicação sobre os canais do Chrome.

Acessar 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 do produto.
platform Um identificador de plataforma.

Identificadores de canal

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
Canary (build de 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 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 assumir a forma de field operator value.

Item Valores válidos
Field version, name, platform, starttime*, endtime* e fraction*
Operador <, <=, =, >, >=
  • A filtragem de canais é feita pela distância do 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 é numérica, por exemplo, 1.0.0.8 < 1.0.0.10. Se uma versão não estiver totalmente gravada, o VersionHistory anexará 0 aos campos ausentes. Por exemplo, version>80 torna-se version>80.0.0.0.
  • Filtros endtime=none para 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 strings.
  • 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 estavam 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 de versão e versão aceitam ordenação. 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, 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 ordem dos canais é feita na seguinte ordem: stable, beta, dev, canary, canary_asan.
  • A ordenação 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 é por platform, channel, version e depois serving.starttime.