Pagespeedapi: runpagespeed

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/v5/runPagespeed

Parametri

Nome del parametro Valore Descrizione
Parametri di query obbligatori
url string L'URL da recuperare e analizzare
Parametri di query facoltativi
category string Una categoria Lighthouse da eseguire; Se non ne viene specificata nessuna, verrà eseguita solo la categoria Rendimento

I valori accettati sono:
  • "accessibility"
  • "best-practices"
  • "performance"
  • "pwa"
  • "seo"
locale string Le impostazioni internazionali utilizzate per localizzare i risultati formattati
strategy string La strategia di analisi (computer o dispositivo mobile) da utilizzare è quella predefinita.

I valori accettati sono:
  • "desktop": recupera e analizza l'URL per i browser desktop
  • "mobile": recupera e analizza l'URL per i dispositivi mobili
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,
  "loadingExperience": {
    "id": string,
    "metrics": {
      (key): {
        "percentile": integer,
        "distributions": [
          {
            "min": integer,
            "max": integer,
            "proportion": double
          }
        ],
        "category": string
      }
    },
    "overall_category": string,
    "initial_url": string
  },
  "originLoadingExperience": {
    "id": string,
    "metrics": {
      (key): {
        "percentile": integer,
        "distributions": [
          {
            "min": integer,
            "max": integer,
            "proportion": double
          }
        ],
        "category": string
      }
    },
    "overall_category": string,
    "initial_url": string
  },
  "lighthouseResult": {
    "requestedUrl": string,
    "finalUrl": string,
    "lighthouseVersion": string,
    "userAgent": string,
    "fetchTime": string,
    "environment": {
      "networkUserAgent": string,
      "hostUserAgent": string,
      "benchmarkIndex": double
    },
    "runWarnings": [
      (value)
    ],
    "configSettings": {
      "emulatedFormFactor": string,
      "locale": string,
      "onlyCategories": (value),
      "onlyCategories": (value)
    },
    "audits": {
      (key): {
        "id": string,
        "title": string,
        "description": string,
        "score": (value),
        "score": (value),
        "scoreDisplayMode": string,
        "displayValue": string,
        "explanation": string,
        "errorMessage": string,
        "warnings": (value),
        "warnings": (value),
        "details": {
          (key): (value)
        }
      }
    },
    "categories": {
      (key): {
        "id": string,
        "title": string,
        "description": string,
        "score": (value),
        "score": (value),
        "manualDescription": string,
        "auditRefs": [
          {
            "id": string,
            "weight": double,
            "group": string
          }
        ]
      }
    },
    "categoryGroups": {
      (key): {
        "title": string,
        "description": string
      }
    },
    "runtimeError": {
      "code": string,
      "message": string
    },
    "timing": {
      "total": double
    },
    "i18n": {
      "rendererFormattedStrings": {
        "varianceDisclaimer": string,
        "opportunityResourceColumnLabel": string,
        "opportunitySavingsColumnLabel": string,
        "errorMissingAuditInfo": string,
        "errorLabel": string,
        "warningHeader": string,
        "auditGroupExpandTooltip": string,
        "passedAuditsGroupTitle": string,
        "notApplicableAuditsGroupTitle": string,
        "manualAuditsGroupTitle": string,
        "toplevelWarningsMessage": string,
        "scorescaleLabel": string,
        "crcLongestDurationLabel": string,
        "crcInitialNavigation": string,
        "lsPerformanceCategoryDescription": string,
        "labDataTitle": string
      }
    }
  },
  "analysisUTCTimestamp": string,
  "version": {
    "major": integer,
    "minor": integer
  }
}
Nome proprietà Valore Descrizione Note
captchaResult string Il risultato della verifica captcha

I valori accettati sono:
  • "CAPTCHA_BLOCKING"
  • "CAPTCHA_MATCHED"
  • "CAPTCHA_NEEDED"
  • "CAPTCHA_NOT_NEEDED"
  • "CAPTCHA_UNMATCHED"
kind string Tipo di risultato.
id string URL canonico e finale del documento, dopo gli eventuali reindirizzamenti delle pagine successivi.
loadingExperience nested 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).distributions[] list
loadingExperience.metrics.(key).distributions[].min integer
loadingExperience.metrics.(key).distributions[].max integer
loadingExperience.metrics.(key).distributions[].proportion double
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.
loadingExperience.metrics.(key).category string

I valori accettati sono:
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
loadingExperience.overall_category string

I valori accettati sono:
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
loadingExperience.initial_url string
loadingExperience.metrics.(key).percentile integer
originLoadingExperience nested object Metriche relative all'esperienza di caricamento delle pagine aggregata dell'origine
originLoadingExperience.id string L'URL, il pattern o l'origine su cui si trovano le metriche.
originLoadingExperience.metrics object
originLoadingExperience.metrics.(key) object Il tipo di metrica.
originLoadingExperience.metrics.(key).percentile integer
originLoadingExperience.metrics.(key).distributions[] list
originLoadingExperience.metrics.(key).distributions[].min integer
originLoadingExperience.metrics.(key).distributions[].max integer
originLoadingExperience.metrics.(key).distributions[].proportion double
originLoadingExperience.metrics.(key).category string

I valori accettati sono:
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
originLoadingExperience.overall_category string

I valori accettati sono:
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
originLoadingExperience.initial_url string
analysisUTCTimestamp string Il timestamp UTC di questa analisi.
lighthouseResult nested object Risposta Lighthouse per l'URL di controllo come oggetto.
lighthouseResult.requestedUrl string L'URL richiesto originale.
lighthouseResult.finalUrl string L'URL risolto finale che è stato controllato.
lighthouseResult.lighthouseVersion string La versione del faro utilizzata per generare questo LHR.
lighthouseResult.userAgent string Lo user agent utilizzato per eseguire questo LHR.
lighthouseResult.fetchTime string L'ora in cui è stata recuperata questa esecuzione.
lighthouseResult.environment object Impostazioni dell'ambiente utilizzate durante la creazione di questo LHR.
lighthouseResult.environment.networkUserAgent string
lighthouseResult.environment.hostUserAgent string
lighthouseResult.environment.benchmarkIndex double
lighthouseResult.runWarnings[] list Elenco di tutti gli avvisi di esecuzione nell'LHR. L'output sarà sempre almeno pari a "[]".
lighthouseResult.configSettings object Le impostazioni di configurazione per questo LHR.
lighthouseResult.configSettings.emulatedFormFactor string Il fattore di forma che deve essere utilizzato dall'emulazione

I valori accettati sono:
  • "UNKNOWN_FORM_FACTOR"
  • "desktop"
  • "mobile"
  • "none"
lighthouseResult.configSettings.locale string Le impostazioni internazionali
lighthouseResult.configSettings.onlyCategories nested object
lighthouseResult.audits object Mappa degli audit nella LHR.
lighthouseResult.audits.(key) nested object
lighthouseResult.audits.(key).id string L'ID del controllo.
lighthouseResult.audits.(key).title string Il titolo leggibile.
lighthouseResult.audits.(key).description string La descrizione del controllo.
lighthouseResult.audits.(key).score nested object
lighthouseResult.audits.(key).scoreDisplayMode string La modalità di visualizzazione dei punteggi enumerati.

I valori accettati sono:
  • "SCORE_DISPLAY_MODE_UNSPECIFIED"
  • "binary"
  • "error"
  • "informative"
  • "manual"
  • "not_applicable"
  • "numeric"
lighthouseResult.audits.(key).displayValue string Il valore da visualizzare nella UI per questo controllo.
lighthouseResult.audits.(key).explanation string Una spiegazione degli errori del controllo.
lighthouseResult.audits.(key).errorMessage string Viene visualizzato un messaggio di errore generato da un errore generato all'interno del controllo.
lighthouseResult.audits.(key).warnings nested object
lighthouseResult.audits.(key).details object Sezione dei dettagli in formato libero del controllo.
lighthouseResult.audits.(key).details.(key) any value
lighthouseResult.categories object Mappa di categorie nella LHR.
lighthouseResult.categories.(key) nested object
lighthouseResult.categories.(key).id string L'identificatore di stringa della categoria.
lighthouseResult.categories.(key).title string Il nome semplice della categoria
lighthouseResult.categories.(key).description string Una descrizione più dettagliata della categoria e della sua importanza.
lighthouseResult.categories.(key).score nested object
lighthouseResult.categories.(key).manualDescription string Una descrizione dei controlli manuali nella categoria.
lighthouseResult.categories.(key).auditRefs[] list Un array di riferimenti a tutti i membri del controllo di questa categoria.
lighthouseResult.categories.(key).auditRefs[].id string L'ID di riferimento di controllo.
lighthouseResult.categories.(key).auditRefs[].weight double La ponderazione del punteggio di questo controllo sul punteggio complessivo della categoria.
lighthouseResult.categories.(key).auditRefs[].group string Il gruppo di categorie a cui appartiene il controllo (facoltativo).
lighthouseResult.categoryGroups object Mappa di gruppi di categorie nel LHR.
lighthouseResult.categoryGroups.(key) object
lighthouseResult.categoryGroups.(key).title string
lighthouseResult.categoryGroups.(key).description string
lighthouseResult.runtimeError object Oggetto contenente il codice e il messaggio di eventuali errori di runtime generati.
lighthouseResult.runtimeError.code string

I valori accettati sono:
  • "ERRORED_DOCUMENT_REQUEST"
  • "FAILED_DOCUMENT_REQUEST"
  • "INSECURE_DOCUMENT_REQUEST"
  • "INVALID_SPEEDLINE"
  • "NO_DCL"
  • "NO_DOCUMENT_REQUEST"
  • "NO_ERROR"
  • "NO_FCP"
  • "NO_NAVSTART"
  • "NO_SCREENSHOTS"
  • "NO_SPEEDLINE_FRAMES"
  • "NO_TRACING_STARTED"
  • "PARSING_PROBLEM"
  • "PROTOCOL_TIMEOUT"
  • "READ_FAILED"
  • "SPEEDINDEX_OF_ZERO"
  • "TRACING_ALREADY_STARTED"
  • "UNKNOWN_ERROR"
lighthouseResult.runtimeError.message string
lighthouseResult.timing object Informazioni sui tempi per questo LHR.
lighthouseResult.timing.total double La durata totale dell'esecuzione di Lighthouse
lighthouseResult.i18n object Le stringhe di internazionalizzazione necessarie per il rendering dell'LHR.
lighthouseResult.i18n.rendererFormattedStrings object
lighthouseResult.i18n.rendererFormattedStrings.varianceDisclaimer string
lighthouseResult.i18n.rendererFormattedStrings.opportunityResourceColumnLabel string
lighthouseResult.i18n.rendererFormattedStrings.opportunitySavingsColumnLabel string
lighthouseResult.i18n.rendererFormattedStrings.errorMissingAuditInfo string
lighthouseResult.i18n.rendererFormattedStrings.errorLabel string
lighthouseResult.i18n.rendererFormattedStrings.warningHeader string
lighthouseResult.i18n.rendererFormattedStrings.auditGroupExpandTooltip string
lighthouseResult.i18n.rendererFormattedStrings.passedAuditsGroupTitle string
lighthouseResult.i18n.rendererFormattedStrings.notApplicableAuditsGroupTitle string
lighthouseResult.i18n.rendererFormattedStrings.manualAuditsGroupTitle string
lighthouseResult.i18n.rendererFormattedStrings.toplevelWarningsMessage string
lighthouseResult.i18n.rendererFormattedStrings.scorescaleLabel string
lighthouseResult.i18n.rendererFormattedStrings.crcLongestDurationLabel string
lighthouseResult.i18n.rendererFormattedStrings.crcInitialNavigation string
lighthouseResult.i18n.rendererFormattedStrings.lsPerformanceCategoryDescription string
lighthouseResult.i18n.rendererFormattedStrings.labDataTitle string

Prova

Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.