Esegue l'analisi PageSpeed sulla pagina all'URL specificato e restituisce i punteggi PageSpeed, un elenco di suggerimenti per rendere la pagina più veloce e altre informazioni. Prova subito.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/pagespeedonline/v4/runPagespeed
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri di query 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 escluse prima dell'analisi PageSpeed.
(Valore predefinito: false )
|
locale |
string |
Le impostazioni internazionali utilizzate per localizzare i risultati formattati |
rule |
string |
Esegui una regola PageSpeed: Se non ne viene specificata nessuna, vengono eseguite tutte le regole |
screenshot |
boolean |
Indica se è necessario includere dati binari contenenti uno screenshot
(Valore predefinito: false )
|
snapshots |
boolean |
Indica se devono essere inclusi dati binari contenenti immagini snapshot
(Valore predefinito: false )
|
strategy |
string |
La strategia di analisi (computer o dispositivo mobile) da utilizzare è quella predefinita.
I valori accettati sono:
|
utm_campaign |
string |
Nome della campagna per Analytics. |
utm_source |
string |
Sorgente campagna per analisi. |
Corpo della richiesta
Non fornire un corpo della 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 |
Il risultato della verifica captcha
I valori accettati sono:
|
|
kind |
string |
Tipo di risultato. | |
id |
string |
URL canonico e finale del documento, dopo gli eventuali reindirizzamenti delle pagine successivi. | |
responseCode |
integer |
Codice di risposta per il documento. 200 indica un caricamento pagina normale. 4xx/5xx indica un errore. | |
title |
string |
Titolo della pagina, come visualizzato nella barra del titolo del browser. | |
ruleGroups |
object |
Una mappa con una voce per ogni gruppo di regole nei 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 potrebbe essere migliore una pagina in quella categoria (ad es. quanto più veloce, quanto più utilizzabile o quanto più sicura). Un punteggio alto indica un margine di miglioramento ridotto, mentre un punteggio più basso indica un margine di miglioramento maggiore. | |
ruleGroups.(key).pass |
boolean |
||
loadingExperience |
object |
Le metriche relative agli utenti finali l'esperienza di caricamento delle pagine. | |
loadingExperience.id |
string |
L'URL, il pattern o l'origine su 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 numero di byte JavaScript, 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 |
Dimensione totale di tutti i byte di richiesta inviati dalla pagina. | |
pageStats.numberStaticResources |
integer |
Numero di risorse statiche (ovvero 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, utilizza la strategia di compressione gzip predefinita come stima. | |
pageStats.cssResponseBytes |
long |
Numero di byte di risposta non compressi per le risorse CSS sulla 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 sulla pagina. | |
pageStats.flashResponseBytes |
long |
Numero di byte di risposta per le risorse Flash sulla pagina. | |
pageStats.otherResponseBytes |
long |
Numero di byte di risposta per 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 robotizzate. | |
pageStats.numberTransientFetchFailureResources |
integer |
Numero di risorse con errori temporanei. | |
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 di URL con errori di recupero temporanei. | |
pageStats.cms |
string |
Sistema di gestione dei contenuti (CMS) utilizzato per la pagina.
I valori accettati sono:
|
|
formattedResults |
object |
Risultati di PageSpeed localizzati. Contiene una voce ruleResults per ogni regola PageSpeed creata ed eseguita dal server. | |
formattedResults.locale |
string |
Le impostazioni internazionali di formattedResults, ad esempio "it_IT". | |
formattedResults.ruleResults |
object |
Dizionario dei risultati delle regole formattate, con una voce per ogni regola PageSpeed creata ed eseguita dal server. | |
formattedResults.ruleResults.(key) |
object |
L'identificatore di tipo enum per questa regola. Ad esempio "AbilitaKeepAlive" o "EvitaCssImport". Non localizzato. | |
formattedResults.ruleResults.(key).localizedRuleName |
string |
Nome localizzato della regola, destinato alla presentazione all'utente. | |
formattedResults.ruleResults.(key).ruleImpact |
double |
L'impatto (valore in virgola mobile illimitato) che l'implementazione dei suggerimenti per questa regola avrebbe su come rendere la pagina più veloce. L'impatto è paragonabile tra le regole per determinare quale regola di suggerimenti avrebbero un impatto maggiore o minore sul miglioramento della velocità di una pagina. Ad esempio, se l'attivazione della compressione risparmierebbe 1 MB, mentre l'ottimizzazione delle immagini risparmierebbe 500 kB, la regola di abilitazione della compressione avrebbe un impatto doppio della regola di ottimizzazione delle immagini, a parità di condizioni. | |
formattedResults.ruleResults.(key).beta |
boolean |
Indica se questa regola è in versione "beta". Le regole nella versione beta sono nuove regole in fase di test e non influiscono sul punteggio complessivo. | |
formattedResults.ruleResults.(key).groups[] |
list |
Elenco dei gruppi di regole a cui appartiene questa regola. Ogni voce dell'elenco può essere "VELOCITÀ", "UTILIZZABILITÀ" o "SICUREZZA". | |
formattedResults.ruleResults.(key).summary |
nested object |
Una breve descrizione riepilogativa della regola che indica, a livello generale, cosa si deve fare per rispettarla e quali vantaggi si possono ottenere facendola. | |
formattedResults.ruleResults.(key).summary.format |
string |
Una stringa di formato localizzata con segnaposto , dove "FOO" è la chiave dell'argomento il cui valore dovrebbe essere sostituito. Per gli argomenti HYPERLINK, la stringa del formato conterrà e per l'argomento con la chiave "FOO". | |
formattedResults.ruleResults.(key).summary.args[] |
list |
Elenco di argomenti per la stringa di 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, come stringa. | |
formattedResults.ruleResults.(key).summary.args[].value |
string |
Valore dell'argomento, come stringa localizzata. | |
formattedResults.ruleResults.(key).summary.args[].rects[] |
list |
I rettangoli dello schermo a cui si fa riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. Se questo non è presente per un argomento SNAPSHOT_RECT, significa che l'argomento si riferisce 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 |
I rettangoli secondari dello schermo a cui si fa 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ò includere facoltativamente dettagli aggiuntivi. | |
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 il cui valore dovrebbe essere sostituito. Per gli argomenti HYPERLINK, la stringa del formato conterrà e per l'argomento con la chiave "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[] |
list |
Elenco di argomenti per la stringa di 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, come 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 dello schermo a cui si fa riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. Se questo non è presente per un argomento SNAPSHOT_RECT, significa che l'argomento si riferisce 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 |
I rettangoli secondari dello schermo a cui si fa 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 url. (Facoltativo) | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result |
nested object |
Una stringa di formato che fornisce informazioni sull'URL e un elenco di argomenti per quella stringa di formato. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.format |
string |
Una stringa di formato localizzata con segnaposto , dove "FOO" è la chiave dell'argomento il cui valore dovrebbe essere sostituito. Per gli argomenti HYPERLINK, la stringa del formato conterrà e per l'argomento con la chiave "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[] |
list |
Elenco di argomenti per la stringa di 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, come 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 dello schermo a cui si fa riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. Se questo non è presente per un argomento SNAPSHOT_RECT, significa che l'argomento si riferisce 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 |
I rettangoli secondari dello schermo a cui si fa 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. (Facoltativo) | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].format |
string |
Una stringa di formato localizzata con segnaposto , dove "FOO" è la chiave dell'argomento il cui valore dovrebbe essere sostituito. Per gli argomenti HYPERLINK, la stringa del formato conterrà e per l'argomento con la chiave "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[] |
list |
Elenco di argomenti per la stringa di 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, come 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 dello schermo a cui si fa riferimento, con dimensioni misurate in pixel CSS. Viene sempre utilizzato solo per gli argomenti SNAPSHOT_RECT. Se questo non è presente per un argomento SNAPSHOT_RECT, significa che l'argomento si riferisce 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 |
I rettangoli secondari dello schermo a cui si fa 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 secondario di PageSpeed utilizzato per generare questi risultati. | |
invalidRules[] |
list |
Elenco di regole specificate nella richiesta, ma di cui il server non sapeva come creare un'istanza. | |
screenshot |
nested object |
Screenshot con codifica Base64 della pagina analizzata. | |
screenshot.key |
string |
Chiave stringa univoca, se presente, che identifica l'immagine. | |
screenshot.mime_type |
string |
Tipo MIME dei dati immagine (ad es. "image/jpeg"). | |
screenshot.data |
bytes |
Dati immagine con codifica 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 parziali. | |
snapshots[].key |
string |
Chiave stringa univoca, se presente, che identifica l'immagine. | |
snapshots[].mime_type |
string |
Tipo MIME dei dati immagine (ad es. "image/jpeg"). | |
snapshots[].data |
bytes |
Dati immagine con codifica 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
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.