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 perstable
,beta
edev
. - 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 accoda0
per i campi mancanti. Ad esempio,version>80
diventaversion>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
oendtime
, il valore deve essere nel formato stringa di data RFC 3339. name
eplatform
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 come1970-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 poiserving.starttime
.