Riferimento API VersionCronologia

Questa pagina contiene informazioni di riferimento tecniche sull'API del servizio web VersionCronologia.

Tutti gli accessi alle API avvengono tramite HTTPS e accessibili da https://versionhistory.googleapis.com/v1.

Versione

Una versione è una particolare istanza di Chrome eseguita dagli utenti.

Ottenere le informazioni sulla versione di una piattaforma e un canale specifici

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

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 inoltre informazioni sulla porzione di utenti che ha eseguito quella versione di Chrome durante questo intervallo.

Scarica tutte le uscite

Elenca tutte le uscite per la piattaforma, il canale e la versione in questione.

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 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 elaborazione 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 di piattaforma

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

Canale

Per avere informazioni sui canali di Chrome, consulta la sezione Come faccio a scegliere il canale da utilizzare?.

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 di canale

L'API Version History supporta i seguenti identificatori di canale:

Descrizione Valore
Stabile esteso extended
Stabile stable
Beta beta
Sviluppo dev
Canarie canary
Canary (creazione variante) canary_asan

Filtra risultati

Aggiungi un parametro di query filter per filtrare i risultati. Solo gli endpoint della versione e della 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 assumere il formato field operator value.

Articolo Valori validi
Campo version, name, platform, starttime*, endtime*, fraction*
Operatore <, <=, =, > e >=
  • Il filtro dei canali 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 completamente, Version History accoda 0 per i campi mancanti. Ad esempio, version>80 diventa version>80.0.0.0.
  • endtime=none filtra per le release attualmente pubblicate e non ancora per cui è stata impostata 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 che Chrome è ancora in fase di pubblicazione, il campo 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 viene compilato.
  • fraction viene utilizzato per specificare quanti utenti sono stati coinvolti nell'implementazione. Ad esempio, fraction=1 indica il 100% degli utenti.

Risultati dell'ordine

Aggiungi un parametro di query order_by ai risultati dell'ordine. Solo gli endpoint di versione e release supportano gli ordini. 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 comportamenti imprevisti, poiché si tratta di un ordinamento con stringhe ingenuo. Ad esempio, 1.0.0.8 sarà precedente a 1.0.0.10 in ordine decrescente.
  • Se order_by non è specificato, l'ordine predefinito è platform, channel, version e poi serving.starttime.