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 parastable
,beta
edev
. - 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 anexar0
aos campos ausentes. Por exemplo,version>80
se tornaversion>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
ouendtime
, o valor precisa estar no formato de string de data RFC 3339. name
eplatform
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 como1970-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
ecanary_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
eserving.starttime
.