Method: 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.

Richiesta HTTP

GET https://pagespeedonline.googleapis.com/pagespeedonline/v5/runPagespeed

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
category

enum (Category)

Una categoria Lighthouse da eseguire; se non viene specificata, verrà eseguita solo la categoria Prestazioni.
locale

string

Le impostazioni internazionali utilizzate per localizzare i risultati formattati
strategy

enum (Strategy)

La strategia di analisi (computer o dispositivo mobile) da utilizzare, l'impostazione predefinita è quella desktop
url

string

Obbligatoria. L'URL da recuperare e analizzare
utm_campaign

string

Nome della campagna per Analytics.
utm_source

string

Sorgente campagna per Analytics.
captchaToken

string

Il token captcha trasmesso durante la compilazione del captcha.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

L'oggetto risposta API Pagespeed.

Rappresentazione JSON 
{
  "kind": string,
  "captchaResult": string,
  "id": string,
  "loadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "originLoadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "analysisUTCTimestamp": string,
  "lighthouseResult": {
    object (LighthouseResultV5)
  },
  "version": {
    object (PagespeedVersion)
  }
}
Campi
kind

string

Tipo di risultato.
captchaResult

string

Il risultato della verifica del captcha
id

string

URL canonico e finale del documento, dopo i seguenti reindirizzamenti di pagina (se presenti).
loadingExperience

object (PagespeedApiLoadingExperienceV5)

Metriche relative all'esperienza di caricamento delle pagine degli utenti finali.
originLoadingExperience

object (PagespeedApiLoadingExperienceV5)

Metriche dell'esperienza di caricamento delle pagine aggregate dell'origine
analysisUTCTimestamp

string

Il timestamp UTC di questa analisi.
lighthouseResult

object (LighthouseResultV5)

Risposta Lighthouse per l'URL di controllo come oggetto.
version

object (PagespeedVersion)

La versione di PageSpeed utilizzata per generare questi risultati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • openid

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

Categoria

Le categorie enumerate da analizzare.

Enum
CATEGORY_UNSPECIFIED Categoria UNDEFINED predefinita.
ACCESSIBILITY Accessibilità (a11y), categoria relativa alla capacità di un sito web di essere accessibile a tutti gli utenti.
BEST_PRACTICES Best practice, categoria relativa alla conformità di un sito web alle best practice sul web.
PERFORMANCE Rendimento, categoria relativa al rendimento di un sito web.
SEO Ottimizzazione per i motori di ricerca (SEO), categoria relativa alla capacità di un sito web di essere indicizzato dai motori di ricerca.

Strategia

La strategia di esecuzione del dispositivo da utilizzare nell'analisi.

Enum
STRATEGY_UNSPECIFIED NON DEFINITA.
DESKTOP Recupera e analizza l'URL per i browser desktop.
MOBILE Recupera e analizza l'URL per dispositivi mobili.

PagespeedApiLoadingExperienceV5

L'oggetto dell'esperienza di caricamento di CrUX che contiene le suddivisioni dei dati CrUX.

Rappresentazione JSON 
{
  "id": string,
  "metrics": {
    string: {
      object (UserPageLoadMetricV5)
    },
    ...
  },
  "overall_category": string,
  "initial_url": string,
  "origin_fallback": boolean
}
Campi
id

string

L'URL, il pattern o l'origine in cui si trovano le metriche.
metrics

map (key: string, value: object (UserPageLoadMetricV5))

La mappa di <metriche, dati>.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
overall_category

string

La "categoria" di velocità leggibile dell'ID.
initial_url

string

L'URL richiesto, che può essere diverso dall'"id" risolto.
origin_fallback

boolean

True se il risultato è un'origine di riserva da una pagina, false negli altri casi.

LighthouseResultV5

L'oggetto risultato Lighthouse.

Rappresentazione JSON 
{
  "fetchTime": string,
  "requestedUrl": string,
  "finalUrl": string,
  "lighthouseVersion": string,
  "i18n": {
    object (I18n)
  },
  "userAgent": string,
  "audits": {
    string: {
      object (LighthouseAuditResultV5)
    },
    ...
  },
  "categoryGroups": {
    string: {
      object (CategoryGroupV5)
    },
    ...
  },
  "stackPacks": [
    {
      object (StackPack)
    }
  ],
  "environment": {
    object (Environment)
  },
  "runWarnings": array,
  "runtimeError": {
    object (RuntimeError)
  },
  "categories": {
    object (Categories)
  },
  "timing": {
    object (Timing)
  },
  "configSettings": {
    object (ConfigSettings)
  }
}
Campi
fetchTime

string

L'ora in cui è stata recuperata questa esecuzione.
requestedUrl

string

L'URL originale richiesto.
finalUrl

string

L'URL finale risolto che è stato controllato.
lighthouseVersion

string

La versione faro utilizzata per generare questo LHR.
i18n

object (I18n)

Le stringhe di internazionalizzazione necessarie per il rendering dell'LHR.
userAgent

string

Lo user agent utilizzato per eseguire questo LHR.
audits

map (key: string, value: object (LighthouseAuditResultV5))

Mappa delle verifiche nell'LHR.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
categoryGroups

map (key: string, value: object (CategoryGroupV5))

Mappa di gruppi di categorie nell'LHR.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stackPacks[]

object (StackPack)

Le stringhe di suggerimenti dello stack Pack.
environment

object (Environment)

Impostazioni dell'ambiente utilizzate durante la creazione di questo LHR.
runWarnings

array (ListValue format)

Elenco di tutti gli avvisi di esecuzione nell'LHR. L'output sarà sempre almeno [].
runtimeError

object (RuntimeError)

Un messaggio di errore di primo livello che, se presente, indica un problema sufficientemente grave da richiedere l'eliminazione di questo risultato Lighthouse.
categories

object (Categories)

Mappa delle categorie nell'LHR.
timing

object (Timing)

Informazioni sulle tempistiche per questo LHR.
configSettings

object (ConfigSettings)

Le impostazioni di configurazione per questo LHR.

Internazionalizzazione

Messaggio contenente i dati i18n per l'LHR - Versione 1.

Rappresentazione JSON 
{
  "rendererFormattedStrings": {
    object (RendererFormattedStrings)
  }
}
Campi
rendererFormattedStrings

object (RendererFormattedStrings)

Stringhe internazionalizzate formattate per le impostazioni internazionali in configSettings.

RendererFormattedStrings

Messaggio che contiene le stringhe formattate utilizzate nel renderer.

Rappresentazione JSON 
{
  "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
}
Campi
varianceDisclaimer

string

Il disclaimer mostrato sotto il valore di una metrica di rendimento.
opportunityResourceColumnLabel

string

L'intestazione dell'opportunità stimata di risparmio del caricamento pagina di un controllo.
opportunitySavingsColumnLabel

string

L'intestazione per la stima dei risparmi durante il caricamento delle pagine dei controlli delle opportunità.
errorMissingAuditInfo

string

La stringa di errore visualizzata accanto a un controllo degli errori.
errorLabel

string

L'etichetta mostrata accanto a un controllo o a una metrica che ha generato un errore.
warningHeader

string

L'etichetta mostrata sopra un elenco puntato di avvisi.
auditGroupExpandTooltip

string

Il testo della descrizione comando su un'icona del gallone espandibile.
passedAuditsGroupTitle

string

L'intestazione mostrata sopra un elenco dei controlli superati.
notApplicableAuditsGroupTitle

string

L'intestazione mostrata sopra è un elenco dei controlli che non si applicano a una pagina.
manualAuditsGroupTitle

string

L'intestazione mostrata sopra un elenco dei controlli non elaborati durante l'esecuzione.
toplevelWarningsMessage

string

L'etichetta mostrata prima di avvisi importanti che potrebbero aver invalidato un intero report.
scorescaleLabel

string

L'etichetta che spiega il punteggio misura la scala (0-49, 50-89, 90-100).
crcLongestDurationLabel

string

L'etichetta per i valori mostrati nel riepilogo delle catene di richieste critiche.
crcInitialNavigation

string

L'etichetta della richiesta iniziale in una catena di richieste critica.
lsPerformanceCategoryDescription

string

La limitazione di responsabilità mostrata sotto le prestazioni che indica che la rete può variare.
labDataTitle

string

Il titolo della categoria di rendimento dei dati del lab.

StackPack

Messaggio contenente informazioni sullo stack Pack.

Rappresentazione JSON 
{
  "id": string,
  "title": string,
  "iconDataURL": string,
  "descriptions": {
    string: string,
    ...
  }
}
Campi
id

string

L'ID stack pack.
title

string

Il titolo dello stack pack.
iconDataURL

string

L'URI dei dati dell'icona del pacchetto stack.
descriptions

map (key: string, value: string)

Le stringhe dei suggerimenti dello stack pack.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Ambiente

Messaggio contenente la configurazione dell'ambiente per un'esecuzione di Lighthouse.

Rappresentazione JSON 
{
  "networkUserAgent": string,
  "hostUserAgent": string,
  "benchmarkIndex": number
}
Campi
networkUserAgent

string

La stringa dello user agent inviata tramite la rete.
hostUserAgent

string

La stringa dello user agent della versione di Chrome utilizzata.
benchmarkIndex

number

Il numero dell'indice di benchmark che indica la classe approssimativa del dispositivo.

RuntimeError

Messaggio contenente una configurazione degli errori di runtime.

Rappresentazione JSON 
{
  "code": string,
  "message": string
}
Campi
code

string

Il codice di errore Lighthouse enumerato.
message

string

Un messaggio leggibile che spiega il codice di errore.

Categorie

Le categorie in un'esecuzione di Lighthouse.

Rappresentazione JSON 
{
  "accessibility": {
    object (LighthouseCategoryV5)
  },
  "best-practices": {
    object (LighthouseCategoryV5)
  },
  "seo": {
    object (LighthouseCategoryV5)
  },
  },
  "performance": {
    object (LighthouseCategoryV5)
  }
}
Campi
accessibility

object (LighthouseCategoryV5)

La categoria di accessibilità, contenente tutti i controlli relativi all'accessibilità.
best-practices

object (LighthouseCategoryV5)

La categoria delle best practice, contenente tutti i controlli correlati alle best practice.
seo

object (LighthouseCategoryV5)

La categoria Ottimizzazione per i motori di ricerca (SEO), contenente tutti i controlli relativi alla SEO.
performance

object (LighthouseCategoryV5)

La categoria di rendimento, contenente tutti i controlli relativi al rendimento.

LighthouseCategoryV5

Una categoria Lighthouse.

Rappresentazione JSON 
{
  "id": string,
  "title": string,
  "description": string,
  "manualDescription": string,
  "auditRefs": [
    {
      object (AuditRefs)
    }
  ],
  "score": value
}
Campi
id

string

L'identificatore stringa della categoria.
title

string

Il nome della categoria in modo intuitivo.
description

string

Una descrizione più dettagliata della categoria e della sua importanza.
manualDescription

string

Una descrizione per i controlli manuali nella categoria.
auditRefs[]

object (AuditRefs)

Un array di riferimenti a tutti i membri del controllo di questa categoria.
score

value (Value format)

Il punteggio complessivo della categoria, la media ponderata di tutti i controlli previsti. (Il punteggio della categoria può essere nullo).

AuditRefs

Un riferimento leggero a un controllo per ID, utilizzato per raggruppare e ponderare i controlli in una determinata categoria.

Rappresentazione JSON 
{
  "id": string,
  "weight": number,
  "group": string
}
Campi
id

string

L'ID di riferimento del controllo.
weight

number

La ponderazione del punteggio di questo controllo rispetto al punteggio complessivo della categoria.
group

string

Il gruppo di categorie a cui appartiene il controllo (facoltativo).

Tempistica

Messaggio contenente i dati sulle tempistiche delle prestazioni per l'esecuzione di Lighthouse.

Rappresentazione JSON 
{
  "total": number
}
Campi
total

number

La durata totale della corsa di Lighthouse.

ConfigSettings

Messaggio contenente le impostazioni di configurazione per l'esecuzione di Lighthouse.

Rappresentazione JSON 
{
  "onlyCategories": value,
  "emulatedFormFactor": string,
  "locale": string,
  "channel": string,
  "formFactor": string
}
Campi
onlyCategories

value (Value format)

Elenco di categorie di controlli che l'esecuzione dovrebbe eseguire.
emulatedFormFactor
(deprecated)

string

Il fattore di forma che deve essere utilizzato dall'emulazione. Questo campo è obsoleto. Al suo posto è necessario utilizzare formFactor.
locale

string

Le impostazioni internazionali.
channel

string

Come è stato eseguito Lighthouse, ad esempio dall'estensione di Chrome o dal modulo npm.
formFactor

string

Come Lighthouse deve interpretare questa esecuzione per quanto riguarda la valutazione delle metriche sul rendimento e l'esclusione dei test solo per dispositivi mobili su computer.

PagespeedVersion

L'oggetto Pagespeed Version.

Rappresentazione JSON 
{
  "major": string,
  "minor": string
}
Campi
major

string

Il numero di versione principale di PageSpeed utilizzato per generare questi risultati.
minor

string

Il numero di versione secondaria di PageSpeed utilizzato per generare questi risultati.