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 parastable
,beta
edev
. - 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 tornaversion>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
ouendtime
, o valor precisa estar no formato de string de data RFC 3339. name
eplatform
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 como1970-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
ecanary_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
eserving.starttime
.