Riferimento API VersionCronologia

Questa pagina contiene informazioni di riferimento tecnico sull'API del servizio web VersionHistory.

Qualsiasi accesso alle API avviene tramite HTTPS e l'accesso viene eseguito da https://versionhistory.googleapis.com/v1.

Versione

Una versione è una particolare istanza di Chrome in esecuzione dagli utenti.

Ottenere informazioni sulla versione per una piattaforma e un canale specifici

Elenca tutte le versioni di Chrome per la piattaforma e il canale specificati.

GET /{product}/platforms/{platform}/channels/{channel}/versions
Nome Descrizione
product Un ID prodotto.
platform Un identificatore di piattaforma.
channel Un identificatore del canale.

Release

Una release è l'intervallo in cui gli utenti hanno eseguito una determinata versione di Chrome. Gli endpoint di rilascio forniscono anche informazioni sulla frazione di utenti che eseguivano quella versione di Chrome durante quell'intervallo.

Ottieni tutte le release

Elenca tutte le release per la piattaforma, il canale e la versione specificati.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
Nome Descrizione
product Un ID prodotto.
platform Un identificatore di piattaforma.
channel Un identificatore del canale.
version Un identificatore di versione.

Prodotto

Un prodotto è un componente software come Chrome o Fuchsia Web Engine.

Identificatori di prodotto

Descrizione Valore
Chrome chrome
Motore web Fuchsia fuchsiawebengine

Piattaforma

Una piattaforma è una delle piattaforme di computing su cui viene eseguito un prodotto, ad esempio Windows, Android e così via.

Scarica tutte le piattaforme

GET /{product}/platforms
Nome Descrizione
product Un ID prodotto.

Ottieni tutte le combinazioni di piattaforma e canale

GET /{product}/platforms/all/channels
Nome Descrizione
product Un ID prodotto.

Identificatori della piattaforma

Descrizione Valore
Tutte le piattaforme all
Windows win
Windows (64 bit) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Lacro lacros

Canale

Consulta la sezione Come faccio a scegliere quale canale utilizzare? per una spiegazione dei canali di Chrome.

Ottieni canali validi di una piattaforma

Elenca i canali validi per una determinata piattaforma:

GET /{product}/platforms/{platform}/channels
Nome Descrizione
product Un ID prodotto.
platform Un identificatore di piattaforma.

Identificatori dei canali

L'API VersionHistory supporta i seguenti identificatori di canale:

Descrizione Valore
Stabile estesa extended
Stabile stable
Beta beta
Sviluppatore dev
Canary canary
canary (creazione della variante) canary_asan

Filtra risultati

Aggiungi un parametro di query filter per filtrare i risultati. Solo gli endpoint versione e release supportano i filtri. Esempio:

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

Il valore di filter deve essere un elenco di espressioni separate da virgole. Ogni espressione deve avere il formato field operator value.

Elemento Valori validi
Campo version, name, platform, starttime*, endtime*, fraction*
Operatore <, <=, =, > e >=
  • Il filtro del canale viene applicato in base alla distanza dal canale stabile, in altre parole stable < beta < dev < canary < canary_asan. Ad esempio, channel<=dev restituisce informazioni per stable, beta e dev.
  • Il filtro delle versioni viene applicato numericamente, ad esempio 1.0.0.8 < 1.0.0.10. Se una versione non è stata scritta interamente, VersionHistory aggiunge 0 per i campi mancanti. Ad esempio, version>80 diventa version>80.0.0.0.
  • endtime=none filtri per le release attualmente pubblicate e che non hanno ancora un'ora di fine.
  • Quando filtri in base a starttime o endtime, il valore deve essere nel formato stringa di data RFC 3339.
  • name e platform sono filtrati in base al confronto tra stringhe.
  • Per le release su cui Chrome è ancora in uso, il campo serving.endtime non verrà compilato. Durante l'ordinamento o il filtro, serving.endtime verrà trattato come 1970-01-01T00:00:00Z se il campo non viene compilato.
  • fraction viene utilizzato per specificare quanti utenti sono stati coinvolti nell'implementazione. Ad esempio, fraction=1 indica il 100% degli utenti.

Risultati degli ordini

Aggiungi un parametro di query order_by per ordinare i risultati. Solo gli endpoint versione e release supportano l'ordinamento. Esempio:

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

order_by accetta un elenco separato da virgole dei seguenti valori: version, name, platform, channel, starttime, endtime, fraction.

Aggiungi uno spazio (%20) seguito da asc o desc dopo il valore order_by per specificare l'ordine crescente o decrescente. Esempio:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • L'ordinamento dei canali viene effettuato nel seguente ordine: stable, beta, dev, canary, canary_asan.
  • L'ordinamento in base a name potrebbe causare un comportamento imprevisto poiché si tratta di un ordinamento ingenuo delle stringhe. Ad esempio, 1.0.0.8 sarà precedente alla data 1.0.0.10 in ordine decrescente.
  • Se order_by non è specificato, l'ordine predefinito è platform, channel, version e poi serving.starttime.