Pagespeedapi: runpagespeed

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

Parametri

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

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 (desktop o mobile) da utilizzare (desktop o mobile) è l'impostazione 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 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,
  "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 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 aver seguito reindirizzamenti di pagina (se presenti).
loadingExperience nested 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).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 minore 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 dell'esperienza di caricamento delle pagine aggregate dell'origine
originLoadingExperience.id string L'URL, il pattern o l'origine in 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 originale richiesto.
lighthouseResult.finalUrl string L'URL finale risolto che è stato controllato.
lighthouseResult.lighthouseVersion string La versione 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 in 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 utilizzare l'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 nell'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 il controllo.
lighthouseResult.audits.(key).explanation string Una spiegazione degli errori del controllo.
lighthouseResult.audits.(key).errorMessage string 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 delle categorie nella LHR.
lighthouseResult.categories.(key) nested object
lighthouseResult.categories.(key).id string L'identificatore stringa della categoria.
lighthouseResult.categories.(key).title string Il nome della categoria a misura di persona
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 del 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 dei gruppi di categorie nell'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 sulle tempistiche per questo LHR.
lighthouseResult.timing.total double La durata totale della corsa 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.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.