Riferimento API VersionCronologia

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

L'accesso all'API avviene tramite HTTPS e da https://versionhistory.googleapis.com/v1.

Versione

Una versione è una determinata istanza di Chrome in esecuzione sugli utenti.

Visualizzare le informazioni sulla versione per una determinata piattaforma e un determinato canale

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 della piattaforma.
channel Un identificatore del canale.

Rilascia

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

Ricevere 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 della piattaforma.
channel Un identificatore del canale.
version Un identificatore della versione.

Prodotto

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

Identificatori di prodotto

Descrizione Valore
Chrome chrome
Fuchsia Web Engine fuchsiawebengine

Piattaforma

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

Tutte le piattaforme

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

Visualizza tutte le combinazioni di piattaforme e canali

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
Lacros lacros

Canale

Per una spiegazione dei canali di Chrome, consulta Come faccio a scegliere quale canale utilizzare?

Trovare i 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 della piattaforma.

Identificatori dei canali

L'API VersionHistory supporta i seguenti identificatori di canale:

Descrizione Valore
Stabile esteso extended
Stabile stable
Beta beta
Sviluppo dev
Canary canary
Canary (build delle varianti) canary_asan

Filtra risultati

Aggiungi un parametro di query filter per filtrare i risultati. Solo gli endpoint version 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 expression deve avere la forma field operator value.

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

Ordina risultati

Aggiungi un parametro di query order_by per ordinare i risultati. Solo gli endpoint version 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 un carattere spazio (%20) seguito da asc o desc dopo il valore order_by per specificare un ordinamento crescente o decrescente. Esempio:

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