Method: pagespeedapi.runpagespeed

Ejecuta un análisis de PageSpeed en la página de la URL especificada y muestra puntuaciones de PageSpeed, una lista de sugerencias para hacer que la página sea más rápida y otra información.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
category

enum (Category)

Una categoría de Lighthouse para ejecutar. Si no se proporciona ninguna, solo se ejecutará la categoría de Rendimiento.
locale

string

La configuración regional que se usa para localizar resultados con formato
strategy

enum (Strategy)

La estrategia de análisis (computadoras de escritorio o dispositivos móviles) que se desea utilizar y la versión para computadoras de escritorio es la predeterminada.
url

string

Obligatorio. La URL que se recuperará y analizará
utm_campaign

string

Nombre de la campaña para estadísticas.
utm_source

string

Fuente de la campaña para Analytics.
captchaToken

string

El token de captcha que se pasa cuando se completa un captcha.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

El objeto de respuesta de la API de Pagespeed.

Representación JSON 
{
  "kind": string,
  "captchaResult": string,
  "id": string,
  "loadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "originLoadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "analysisUTCTimestamp": string,
  "lighthouseResult": {
    object (LighthouseResultV5)
  },
  "version": {
    object (PagespeedVersion)
  }
}
Campos
kind

string

Tipo de resultado.
captchaResult

string

El resultado de la verificación de captcha
id

string

Es la URL canonicalizada y final del documento, después de los redireccionamientos de página siguientes (si corresponde).
loadingExperience

object (PagespeedApiLoadingExperienceV5)

Son métricas de la experiencia de carga de la página de los usuarios finales.
originLoadingExperience

object (PagespeedApiLoadingExperienceV5)

Métricas de la experiencia de carga de páginas agregada del origen
analysisUTCTimestamp

string

La marca de tiempo UTC de este análisis.
lighthouseResult

object (LighthouseResultV5)

Respuesta de Lighthouse para la URL de auditoría como un objeto
version

object (PagespeedVersion)

Es la versión de PageSpeed que se usa para generar estos resultados.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

  • openid

Para obtener más información, consulta la Descripción general de OAuth 2.0.

Categoría

Las categorías enumeradas que se deben analizar.

Enumeradores
CATEGORY_UNSPECIFIED Categoría predeterminada UNDEFINED.
ACCESSIBILITY Accesibilidad (a11y): Es una categoría que corresponde a la capacidad de un sitio web de ser accesible para todos los usuarios.
BEST_PRACTICES Prácticas recomendadas, categoría relacionada con el cumplimiento de un sitio web con las prácticas recomendadas para la Web.
PERFORMANCE Rendimiento, categoría relacionada con el rendimiento de un sitio web.
PWA App web progresiva (AWP): Es una categoría que corresponde a la capacidad de un sitio web para ejecutarse como una AWP.
SEO Optimización del motor de búsqueda (SEO), categoría relacionada con la capacidad de un sitio web para que los motores de búsqueda lo indexen.

de doblaje

Es la estrategia de ejecución del dispositivo que se usará en el análisis.

Enumeradores
STRATEGY_UNSPECIFIED SIN DEFINIR.
DESKTOP Recupera y analiza la URL para navegadores de escritorio.
MOBILE Recupera y analiza la URL para dispositivos móviles.

PagespeedApiLoadingExperienceV5

El objeto de experiencia de carga de CrUX que contiene desgloses de datos de CrUX

Representación JSON 
{
  "id": string,
  "metrics": {
    string: {
      object (UserPageLoadMetricV5)
    },
    ...
  },
  "overall_category": string,
  "initial_url": string,
  "origin_fallback": boolean
}
Campos
id

string

La URL, el patrón o el origen en los que se encuentran las métricas.
metrics

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

El mapa de <metrics, data>.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
overall_category

string

Es la "categoría" de velocidad legible del ID.
initial_url

string

Es la URL solicitada, que puede diferir del "id" resuelto.
origin_fallback

boolean

Verdadero si el resultado es un resguardo de origen de una página; de lo contrario, es falso.

LighthouseResultV5

El objeto de resultado de Lighthouse.

Representación 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)
  }
}
Campos
fetchTime

string

La hora a la que se recuperó esta ejecución.
requestedUrl

string

Es la URL solicitada originalmente.
finalUrl

string

La URL final resuelta que se auditó.
lighthouseVersion

string

Es la versión del faro que se usó para generar este LHR.
i18n

object (I18n)

Las cadenas de internacionalización necesarias para renderizar el LHR.
userAgent

string

El usuario-agente que se usó para ejecutar este LHR.
audits

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

Mapa de las auditorías en el LHR.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
categoryGroups

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

Mapa de grupos de categorías en el LHR

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stackPacks[]

object (StackPack)

Las cadenas de asesoramiento del paquete de pila.
environment

object (Environment)

La configuración del entorno que se usó cuando se creó este LHR.
runWarnings

array (ListValue format)

Lista de todas las advertencias de ejecución en el LHR. Siempre se mostrará como mínimo [].
runtimeError

object (RuntimeError)

Un mensaje de error de nivel superior que, si está presente, indica un problema lo suficientemente grave como para que este resultado de Lighthouse deba descartarse.
categories

object (Categories)

Mapa de categorías en el LHR
timing

object (Timing)

Información de sincronización para este LHR.
configSettings

object (ConfigSettings)

Es la configuración de este LHR.

I18n

Mensaje que contiene los datos de i18n para la versión 1 de LHR.

Representación JSON 
{
  "rendererFormattedStrings": {
    object (RendererFormattedStrings)
  }
}
Campos
rendererFormattedStrings

object (RendererFormattedStrings)

Strings internacionalizadas que tienen el formato de la configuración regional en configSettings.

RendererFormattedStrings

Mensaje que contiene las strings con formato que se usaron en el procesador.

Representación 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
}
Campos
varianceDisclaimer

string

La renuncia de responsabilidad que se muestra debajo de un valor de métrica de rendimiento.
opportunityResourceColumnLabel

string

El encabezado de la oportunidad de ahorro estimado en la carga de páginas de una auditoría.
opportunitySavingsColumnLabel

string

Encabezado de los ahorros estimados en la carga de páginas de las auditorías de oportunidades.
errorMissingAuditInfo

string

La cadena de error que se muestra junto a una auditoría con errores.
errorLabel

string

Es la etiqueta que se muestra junto a una auditoría o métrica que tiene un error.
warningHeader

string

La etiqueta que se muestra sobre una lista con viñetas de advertencias.
auditGroupExpandTooltip

string

El texto de información sobre la herramienta en un ícono de cheurón expandible.
passedAuditsGroupTitle

string

El encabezado que se muestra sobre una lista de auditorías aprobadas.
notApplicableAuditsGroupTitle

string

El encabezado que se muestra sobre una lista de auditorías que no se aplican a una página.
manualAuditsGroupTitle

string

El encabezado que se muestra sobre una lista de auditorías que no se procesaron durante la ejecución.
toplevelWarningsMessage

string

La etiqueta que se muestra antes de las advertencias importantes que pueden haber invalidado un informe completo.
scorescaleLabel

string

Es la etiqueta que explica la escala de los medidores de puntuación (0-49, 50-89, 90-100).
crcLongestDurationLabel

string

La etiqueta para los valores que se muestran en el resumen de las cadenas de solicitudes críticas.
crcInitialNavigation

string

La etiqueta de la solicitud inicial en una cadena de solicitudes crítica.
lsPerformanceCategoryDescription

string

La renuncia de responsabilidad que se muestra en el informe de rendimiento que indica que la red puede variar.
labDataTitle

string

Es el título de la categoría de rendimiento de los datos de lab.

StackPack

Mensaje que contiene información sobre el paquete de pila.

Representación JSON 
{
  "id": string,
  "title": string,
  "iconDataURL": string,
  "descriptions": {
    string: string,
    ...
  }
}
Campos
id

string

Es el ID del paquete de pila.
title

string

Es el título del paquete de pila.
iconDataURL

string

El URI de datos del ícono del paquete de pila.
descriptions

map (key: string, value: string)

Las cadenas de consejo del paquete de pila.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Entorno

Mensaje que contiene la configuración del entorno para una ejecución de Lighthouse.

Representación JSON 
{
  "networkUserAgent": string,
  "hostUserAgent": string,
  "benchmarkIndex": number
}
Campos
networkUserAgent

string

La string de usuario-agente que se envió a través de la red.
hostUserAgent

string

Es la cadena de usuario-agente de la versión de Chrome utilizada.
benchmarkIndex

number

El número de índice de las comparativas que indica la clase aproximada de dispositivo.

RuntimeError

Mensaje que contiene una configuración de error del entorno de ejecución.

Representación JSON 
{
  "code": string,
  "message": string
}
Campos
code

string

El código de error de Lighthouse enumerado.
message

string

Un mensaje legible en el que se explica el código de error.

Categorías

Las categorías en un Lighthouse se ejecutan.

Representación JSON 
{
  "accessibility": {
    object (LighthouseCategoryV5)
  },
  "best-practices": {
    object (LighthouseCategoryV5)
  },
  "seo": {
    object (LighthouseCategoryV5)
  },
  "pwa": {
    object (LighthouseCategoryV5)
  },
  "performance": {
    object (LighthouseCategoryV5)
  }
}
Campos
accessibility

object (LighthouseCategoryV5)

La categoría de accesibilidad, que contiene todas las auditorías relacionadas con la accesibilidad.
best-practices

object (LighthouseCategoryV5)

La categoría de prácticas recomendadas, que contiene todas las auditorías relacionadas con las prácticas recomendadas.
seo

object (LighthouseCategoryV5)

La categoría Optimización del motor de búsqueda (SEO), que contiene todas las auditorías relacionadas con SEO.
pwa

object (LighthouseCategoryV5)

La categoría de app web progresiva (AWP), que contiene todas las auditorías relacionadas con la PPA.
performance

object (LighthouseCategoryV5)

La categoría de rendimiento, que contiene todas las auditorías relacionadas con el rendimiento.

LighthouseCategoryV5

Una categoría de Lighthouse.

Representación JSON 
{
  "id": string,
  "title": string,
  "description": string,
  "manualDescription": string,
  "auditRefs": [
    {
      object (AuditRefs)
    }
  ],
  "score": value
}
Campos
id

string

Es el identificador de string de la categoría.
title

string

Es el nombre sencillo de la categoría.
description

string

Una descripción más detallada de la categoría y su importancia.
manualDescription

string

Una descripción de las auditorías manuales en la categoría.
auditRefs[]

object (AuditRefs)

Un array de referencias a todos los miembros de auditoría de esta categoría.
score

value (Value format)

La puntuación general de la categoría, el promedio ponderado de todas sus auditorías. (La puntuación de la categoría puede ser nula).

AuditRefs

Es una referencia ligera a una auditoría por ID, que se usa para agrupar y ponderar las auditorías en una categoría determinada.

Representación JSON 
{
  "id": string,
  "weight": number,
  "group": string
}
Campos
id

string

Es el ID de referencia de auditoría.
weight

number

El peso que tiene la puntuación de esta auditoría sobre la puntuación general de la categoría.
group

string

El grupo de categorías al que pertenece la auditoría (opcional).

Tiempos

Mensaje que contiene los datos de los tiempos de rendimiento de la ejecución de Lighthouse.

Representación JSON 
{
  "total": number
}
Campos
total

number

La duración total de la ejecución de Lighthouse.

ConfigSettings

Mensaje que contiene los parámetros de configuración de la ejecución de Lighthouse.

Representación JSON 
{
  "onlyCategories": value,
  "emulatedFormFactor": string,
  "locale": string,
  "channel": string,
  "formFactor": string
}
Campos
onlyCategories

value (Value format)

Lista de categorías de auditorías que debe realizar la ejecución.
emulatedFormFactor
(deprecated)

string

El factor de forma que debe usar la emulación. Este campo dejó de estar disponible. En su lugar, se debe usar formFactor.
locale

string

La configuración regional.
channel

string

Cómo se ejecutó Lighthouse, p.ej., desde la extensión de Chrome o desde el módulo de npm.
formFactor

string

Cómo Lighthouse debería interpretar esta ejecución con respecto a la puntuación de las métricas de rendimiento y la omisión de las pruebas exclusivas para dispositivos móviles en computadoras de escritorio.

PagespeedVersion

El objeto Pagespeed Version.

Representación JSON 
{
  "major": string,
  "minor": string
}
Campos
major

string

Es el número de versión principal de PageSpeed que se usa para generar estos resultados.
minor

string

Es el número de versión secundaria de PageSpeed que se usa para generar estos resultados.