Esegue l'analisi PageSpeed sulla pagina all'URL specificato e restituisce i punteggi PageSpeed, un elenco di suggerimenti per rendere più veloce la pagina e altre informazioni. Prova subito.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/pagespeedonline/v4/runPagespeed
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri di ricerca obbligatori | ||
url |
string |
L'URL da recuperare e analizzare |
Parametri di query facoltativi | ||
filter_third_party_resources |
boolean |
Indica se le risorse di terze parti devono essere filtrate prima dell'analisi PageSpeed.
(valore predefinito: false )
|
locale |
string |
Le impostazioni internazionali utilizzate per localizzare i risultati formattati |
rule |
string |
Una regola PageSpeed da eseguire; se non viene specificata alcuna regola, vengono eseguite tutte le regole |
screenshot |
boolean |
Indica se i dati binari contenenti uno screenshot devono essere inclusi (valore predefinito: false )
|
snapshots |
boolean |
Indica se i dati binari contenenti immagini snapshot devono essere inclusi (valore predefinito: false )
|
strategy |
string |
La strategia di analisi (desktop o mobile) da utilizzare (desktop o mobile) è l'impostazione predefinita.
I valori accettati sono:
|
utm_campaign |
string |
Nome della campagna per Analytics. |
utm_source |
string |
Sorgente campagna per Analytics. |
Corpo della richiesta
Non fornire il corpo di una richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{ "captchaResult": string, "kind": "pagespeedonline#result", "id": string, "responseCode": integer, "title": string, "ruleGroups": { (key): { "score": integer, "pass": boolean } }, "loadingExperience": { "id": string, "metrics": { (key): { "median": integer, "distributions": [ { "min": integer, "max": integer, "proportion": double } ], "category": string } }, "overall_category": string, "initial_url": string }, "pageStats": { "numberResources": integer, "numberHosts": integer, "totalRequestBytes": long, "numberStaticResources": integer, "htmlResponseBytes": long, "textResponseBytes": long, "overTheWireResponseBytes": long, "cssResponseBytes": long, "imageResponseBytes": long, "javascriptResponseBytes": long, "flashResponseBytes": long, "otherResponseBytes": long, "numberJsResources": integer, "numberCssResources": integer, "numberRobotedResources": integer, "numberTransientFetchFailureResources": integer, "numTotalRoundTrips": integer, "numRenderBlockingRoundTrips": integer, "robotedUrls": [ string ], "transientFetchFailureUrls": [ string ], "cms": string }, "formattedResults": { "locale": string, "ruleResults": { (key): { "localizedRuleName": string, "ruleImpact": double, "beta": boolean, "groups": [ string ], "summary": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "urlBlocks": [ { "header": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "urls": [ { "result": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "details": [ { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] } ] } ] } ] } } }, "version": { "major": integer, "minor": integer }, "invalidRules": [ string ], "screenshot": { "key": string, "mime_type": string, "data": bytes, "width": integer, "height": integer, "page_rect": { "left": integer, "top": integer, "width": integer, "height": integer } }, "snapshots": [ { "key": string, "mime_type": string, "data": bytes, "width": integer, "height": integer, "page_rect": { "left": integer, "top": integer, "width": integer, "height": integer } } ] }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
captchaResult |
string |
Risultato della verifica captcha
I valori accettati sono:
|
|
kind |
string |
Tipo di risultato. | |
id |
string |
URL canonico e finale del documento, dopo aver seguito reindirizzamenti di pagina (se presenti). | |
responseCode |
integer |
Codice di risposta per il documento. 200 indica un normale caricamento della pagina. 4xx/5xx indica un errore. | |
title |
string |
Titolo della pagina, visualizzato nella barra del titolo del browser. | |
ruleGroups |
object |
Una mappa con una voce per ogni gruppo di regole in questi risultati. | |
ruleGroups.(key) |
object |
Il nome di questo gruppo di regole: "VELOCITÀ", "USABILITÀ" o "SICUREZZA". | |
ruleGroups.(key).score |
integer |
Il punteggio (0-100) per questo gruppo di regole, che indica quanto migliore potrebbe essere una pagina in quella categoria (ad es. quanto più veloce, quanto più utilizzabile o quanto più sicura). Un punteggio alto indica poco margine di miglioramento, mentre un punteggio più basso indica più margine di miglioramento. | |
ruleGroups.(key).pass |
boolean |
||
loadingExperience |
object |
Metriche relative all'esperienza di caricamento delle pagine degli utenti finali. | |
loadingExperience.id |
string |
L'URL, il pattern o l'origine in cui si trovano le metriche. | |
loadingExperience.metrics |
object |
||
loadingExperience.metrics.(key) |
object |
Il tipo di metrica. | |
loadingExperience.metrics.(key).median |
integer |
||
loadingExperience.metrics.(key).distributions[] |
list |
||
loadingExperience.metrics.(key).distributions[].min |
integer |
||
loadingExperience.metrics.(key).distributions[].max |
integer |
||
loadingExperience.metrics.(key).distributions[].proportion |
double |
||
pageStats |
object |
Statistiche di riepilogo della pagina, ad esempio il numero di byte JavaScript, il numero di byte HTML e così via | |
pageStats.numberResources |
integer |
Numero di risorse HTTP caricate dalla pagina. | |
pageStats.numberHosts |
integer |
Numero di host univoci a cui fa riferimento la pagina. | |
pageStats.totalRequestBytes |
long |
Dimensioni totali di tutti i byte di richiesta inviati dalla pagina. | |
pageStats.numberStaticResources |
integer |
Numero di risorse statiche (ossia memorizzabili nella cache) nella pagina. | |
pageStats.htmlResponseBytes |
long |
Numero di byte di risposta non compressi per il documento HTML principale e tutti gli iframe della pagina. | |
pageStats.textResponseBytes |
long |
Numero di byte di risposta non compressi per le risorse di testo non coperte da altre statistiche (ad es.risorse non HTML, non script e non CSS) nella pagina. | |
pageStats.overTheWireResponseBytes |
long |
Numero di byte over-the-wire; viene utilizzata la strategia di compressione gzip predefinita come stima. | |
pageStats.cssResponseBytes |
long |
Numero di byte di risposta non compressi per le risorse CSS nella pagina. | |
pageStats.imageResponseBytes |
long |
Numero di byte di risposta per le risorse immagine nella pagina. | |
pageStats.javascriptResponseBytes |
long |
Numero di byte di risposta non compressi per le risorse JS nella pagina. | |
pageStats.flashResponseBytes |
long |
Numero di byte di risposta per le risorse Flash nella pagina. | |
pageStats.otherResponseBytes |
long |
Numero di byte di risposta per le altre risorse nella pagina. | |
pageStats.numberJsResources |
integer |
Numero di risorse JavaScript a cui fa riferimento la pagina. | |
pageStats.numberCssResources |
integer |
Numero di risorse CSS a cui fa riferimento la pagina. | |
pageStats.numberRobotedResources |
integer |
Numero di risorse sottoposte a scansione. | |
pageStats.numberTransientFetchFailureResources |
integer |
Numero di risorse in errore temporaneo. | |
pageStats.numTotalRoundTrips |
integer |
I viaggi di andata e ritorno necessari per caricare la pagina intera | |
pageStats.numRenderBlockingRoundTrips |
integer |
I round trip necessari per caricare le risorse di blocco del rendering | |
pageStats.robotedUrls[] |
list |
Elenco di URL robotizzati. | |
pageStats.transientFetchFailureUrls[] |
list |
Elenco degli URL di errori di recupero temporanei. | |
pageStats.cms |
string |
Sistema di gestione dei contenuti (CMS) utilizzato per la pagina.
I valori accettati sono:
|
|
formattedResults |
object |
Risultati PageSpeed localizzati. Contiene una voceruleResults per ogni regola PageSpeed creata e eseguita dal server. | |
formattedResults.locale |
string |
Le impostazioni internazionali dell'elemento formattedResults, ad esempio "en_US". | |
formattedResults.ruleResults |
object |
Dizionario dei risultati delle regole formattate, con una voce per ogni regola PageSpeed creata un'istanza ed eseguita dal server. | |
formattedResults.ruleResults.(key) |
object |
L'identificatore di tipo enum per questa regola. Ad esempio, "EnableKeepAlive" o "PreventCssImport". Non localizzato. | |
formattedResults.ruleResults.(key).localizedRuleName |
string |
Nome localizzato della regola, destinato alla presentazione a un utente. | |
formattedResults.ruleResults.(key).ruleImpact |
double |
L'impatto (valore in virgola mobile illimitato) che l'implementazione dei suggerimenti per questa regola avrebbe sul rendere la pagina più veloce. L'impatto è paragonabile tra le regole per determinare quali suggerimenti della regola avrebbero un impatto maggiore o minore sulla velocità di una pagina. Ad esempio, se l'attivazione della compressione salverebbe 1 MB e l'ottimizzazione delle immagini risparmierebbe 500 kB, la regola di attivazione della compressione avrebbe il doppio dell'impatto della regola di ottimizzazione dell'immagine, a parità di altri aspetti. | |
formattedResults.ruleResults.(key).beta |
boolean |
Se questa regola è in versione "beta". Le regole in versione beta sono nuove regole in fase di test che non influiscono sul punteggio complessivo. | |
formattedResults.ruleResults.(key).groups[] |
list |
Elenco dei gruppi di regole a cui appartiene questa regola. Ciascuna voce nell'elenco può essere "VELOCITÀ", "USABILITY" o "SICUREZZA". | |
formattedResults.ruleResults.(key).summary |
nested object |
Una breve descrizione riepilogativa della regola, che indica in generale cosa si deve fare per seguirla e quali vantaggi si possono ottenere in questo modo. | |
formattedResults.ruleResults.(key).summary.format |
string |
Una stringa di formato localizzata con segnaposto , dove "FOO" è la chiave dell'argomento di cui deve essere sostituito il valore. Per gli argomenti HYPERLINK, la stringa di formato conterrà invece e per l'argomento con la chiave "FOO". | |
formattedResults.ruleResults.(key).summary.args[] |
list |
Elenco di argomenti per la stringa del formato. | |
formattedResults.ruleResults.(key).summary.args[].type |
string |
Tipo di argomento. Uno tra URL, STRING_LITERAL, INT_LITERAL, BYTES, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK o SNAPSHOT_RECT.
I valori accettati sono:
|
|
formattedResults.ruleResults.(key).summary.args[].key |
string |
La chiave segnaposto per questo argomento, sotto forma di stringa. | |
formattedResults.ruleResults.(key).summary.args[].value |
string |
Valore dell'argomento, come stringa localizzata. | |
formattedResults.ruleResults.(key).summary.args[].rects[] |
list |
I rettangoli di schermo a cui viene fatto riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. Se non è presente in un argomento SNAPSHOT_RECT, significa che quell'argomento fa riferimento all'intero snapshot. | |
formattedResults.ruleResults.(key).summary.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[] |
list |
Rettangolo di schermo secondario a cui viene fatto riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[] |
list |
Elenco di blocchi di URL. Ogni blocco può contenere un'intestazione e un elenco di URL. Ogni URL può facoltativamente includere ulteriori dettagli. | |
formattedResults.ruleResults.(key).urlBlocks[].header |
nested object |
Intestazione da visualizzare con l'elenco di URL. | |
formattedResults.ruleResults.(key).urlBlocks[].header.format |
string |
Una stringa di formato localizzata con segnaposto , dove "FOO" è la chiave dell'argomento di cui deve essere sostituito il valore. Per gli argomenti HYPERLINK, la stringa di formato conterrà invece e per l'argomento con la chiave "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[] |
list |
Elenco di argomenti per la stringa del formato. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].type |
string |
Tipo di argomento. Uno tra URL, STRING_LITERAL, INT_LITERAL, BYTES, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK o SNAPSHOT_RECT.
I valori accettati sono:
|
|
formattedResults.ruleResults.(key).urlBlocks[].header.args[].key |
string |
La chiave segnaposto per questo argomento, sotto forma di stringa. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].value |
string |
Valore dell'argomento, come stringa localizzata. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[] |
list |
I rettangoli di schermo a cui viene fatto riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. Se non è presente in un argomento SNAPSHOT_RECT, significa che quell'argomento fa riferimento all'intero snapshot. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[] |
list |
Rettangolo di schermo secondario a cui viene fatto riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[] |
list |
Elenco di voci che forniscono informazioni sugli URL nel blocco di URL. Campo facoltativo. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result |
nested object |
Una stringa di formato che fornisce informazioni sull'URL e un elenco di argomenti per tale stringa di formato. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.format |
string |
Una stringa di formato localizzata con segnaposto , dove "FOO" è la chiave dell'argomento di cui deve essere sostituito il valore. Per gli argomenti HYPERLINK, la stringa di formato conterrà invece e per l'argomento con la chiave "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[] |
list |
Elenco di argomenti per la stringa del formato. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].type |
string |
Tipo di argomento. Uno tra URL, STRING_LITERAL, INT_LITERAL, BYTES, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK o SNAPSHOT_RECT.
I valori accettati sono:
|
|
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].key |
string |
La chiave segnaposto per questo argomento, sotto forma di stringa. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].value |
string |
Valore dell'argomento, come stringa localizzata. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[] |
list |
I rettangoli di schermo a cui viene fatto riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. Se non è presente in un argomento SNAPSHOT_RECT, significa che quell'argomento fa riferimento all'intero snapshot. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[] |
list |
Rettangolo di schermo secondario a cui viene fatto riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[] |
list |
Elenco di voci che forniscono ulteriori dettagli su un singolo URL. Campo facoltativo. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].format |
string |
Una stringa di formato localizzata con segnaposto , dove "FOO" è la chiave dell'argomento di cui deve essere sostituito il valore. Per gli argomenti HYPERLINK, la stringa di formato conterrà invece e per l'argomento con la chiave "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[] |
list |
Elenco di argomenti per la stringa del formato. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].type |
string |
Tipo di argomento. Uno tra URL, STRING_LITERAL, INT_LITERAL, BYTES, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK o SNAPSHOT_RECT.
I valori accettati sono:
|
|
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].key |
string |
La chiave segnaposto per questo argomento, sotto forma di stringa. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].value |
string |
Valore dell'argomento, come stringa localizzata. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[] |
list |
I rettangoli di schermo a cui viene fatto riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. Se non è presente in un argomento SNAPSHOT_RECT, significa che quell'argomento fa riferimento all'intero snapshot. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[] |
list |
Rettangolo di schermo secondario a cui viene fatto riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].height |
integer |
||
version |
object |
La versione di PageSpeed utilizzata per generare questi risultati. | |
version.major |
integer |
Il numero di versione principale di PageSpeed utilizzato per generare questi risultati. | |
version.minor |
integer |
Il numero di versione minore di PageSpeed utilizzato per generare questi risultati. | |
invalidRules[] |
list |
Elenco di regole che sono state specificate nella richiesta, ma che il server non sa come creare un'istanza. | |
screenshot |
nested object |
Screenshot con codifica Base64 della pagina analizzata. | |
screenshot.key |
string |
Chiave stringa univoca, se presente, che identifica questa immagine. | |
screenshot.mime_type |
string |
Tipo MIME dei dati di immagine (ad es. "image/jpeg"). | |
screenshot.data |
bytes |
Dati immagine codificati in Base64. | |
screenshot.width |
integer |
Larghezza dello screenshot in pixel. | |
screenshot.height |
integer |
Altezza dello screenshot in pixel. | |
screenshot.page_rect |
object |
||
screenshot.page_rect.left |
integer |
||
screenshot.page_rect.top |
integer |
||
screenshot.page_rect.width |
integer |
||
screenshot.page_rect.height |
integer |
||
snapshots[] |
list |
Screenshot aggiuntivi con codifica Base64 della pagina, in vari stati di rendering parziale. | |
snapshots[].key |
string |
Chiave stringa univoca, se presente, che identifica questa immagine. | |
snapshots[].mime_type |
string |
Tipo MIME dei dati di immagine (ad es. "image/jpeg"). | |
snapshots[].data |
bytes |
Dati immagine codificati in Base64. | |
snapshots[].width |
integer |
Larghezza dello screenshot in pixel. | |
snapshots[].height |
integer |
Altezza dello screenshot in pixel. | |
snapshots[].page_rect |
object |
||
snapshots[].page_rect.left |
integer |
||
snapshots[].page_rect.top |
integer |
||
snapshots[].page_rect.width |
integer |
||
snapshots[].page_rect.height |
integer |
||
loadingExperience.metrics.(key).category |
string |
I valori accettati sono:
|
|
loadingExperience.overall_category |
string |
I valori accettati sono:
|
|
loadingExperience.initial_url |
string |
Prova.
Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.