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. Pruébalo ahora.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de consulta obligatorios
url string La URL que se recuperará y analizará
Parámetros de consulta opcionales
category string Una categoría de Lighthouse para ejecutar. Si no se proporciona ninguna, solo se ejecutará la categoría de Rendimiento.

Los valores aceptables son los siguientes:
  • "accessibility"
  • "best-practices"
  • "performance"
  • "pwa"
  • "seo"
locale string La configuración regional que se usa para localizar resultados con formato
strategy string La estrategia de análisis (computadoras de escritorio o dispositivos móviles) que se debe usar y la estrategia predeterminada para computadoras de escritorio

Los valores aceptables son los siguientes:
  • "desktop": Recupera y analiza la URL para navegadores de escritorio
  • "mobile": Recupera y analiza la URL para dispositivos móviles.
utm_campaign string Nombre de la campaña para estadísticas.
utm_source string Fuente de la campaña para Analytics.

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud con este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "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
  }
}
Nombre de la propiedad Valor Descripción Notas
captchaResult string Resultado de la verificación de captcha

Los valores aceptables son los siguientes:
  • "CAPTCHA_BLOCKING"
  • "CAPTCHA_MATCHED"
  • "CAPTCHA_NEEDED"
  • "CAPTCHA_NOT_NEEDED"
  • "CAPTCHA_UNMATCHED"
kind string Tipo de resultado.
id string Es la URL canonicalizada y final del documento, después de los redireccionamientos de página siguientes (si corresponde).
loadingExperience nested object Son métricas de la experiencia de carga de la página de los usuarios finales.
loadingExperience.id string La URL, el patrón o el origen en los que se encuentran las métricas.
loadingExperience.metrics object
loadingExperience.metrics.(key) object Es el tipo de métrica.
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 Es la versión de PageSpeed que se usa para generar estos resultados.
version.major integer Es el número de versión principal de PageSpeed que se usa para generar estos resultados.
version.minor integer Es el número de versión secundaria de PageSpeed que se usa para generar estos resultados.
loadingExperience.metrics.(key).category string

Los valores aceptables son los siguientes:
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
loadingExperience.overall_category string

Los valores aceptables son los siguientes:
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
loadingExperience.initial_url string
loadingExperience.metrics.(key).percentile integer
originLoadingExperience nested object Métricas de la experiencia de carga de páginas agregada del origen
originLoadingExperience.id string La URL, el patrón o el origen en los que se encuentran las métricas.
originLoadingExperience.metrics object
originLoadingExperience.metrics.(key) object Es el tipo de métrica.
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

Los valores aceptables son los siguientes:
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
originLoadingExperience.overall_category string

Los valores aceptables son los siguientes:
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
originLoadingExperience.initial_url string
analysisUTCTimestamp string La marca de tiempo UTC de este análisis.
lighthouseResult nested object Respuesta de Lighthouse para la URL de auditoría como un objeto
lighthouseResult.requestedUrl string Es la URL solicitada originalmente.
lighthouseResult.finalUrl string La URL final resuelta que se auditó.
lighthouseResult.lighthouseVersion string Es la versión del faro que se usó para generar este LHR.
lighthouseResult.userAgent string El usuario-agente que se usó para ejecutar este LHR.
lighthouseResult.fetchTime string La hora a la que se recuperó esta ejecución.
lighthouseResult.environment object La configuración del entorno que se usó cuando se creó este LHR.
lighthouseResult.environment.networkUserAgent string
lighthouseResult.environment.hostUserAgent string
lighthouseResult.environment.benchmarkIndex double
lighthouseResult.runWarnings[] list Lista de todas las advertencias de ejecución en el LHR. Siempre se mostrará como mínimo `[]`.
lighthouseResult.configSettings object Es la configuración de este LHR.
lighthouseResult.configSettings.emulatedFormFactor string El factor de forma que debe usar la emulación

Los valores aceptables son los siguientes:
  • "UNKNOWN_FORM_FACTOR"
  • "desktop"
  • "mobile"
  • "none"
lighthouseResult.configSettings.locale string La configuración regional
lighthouseResult.configSettings.onlyCategories nested object
lighthouseResult.audits object Mapa de las auditorías en el LHR.
lighthouseResult.audits.(key) nested object
lighthouseResult.audits.(key).id string El ID de la auditoría.
lighthouseResult.audits.(key).title string Es el título legible.
lighthouseResult.audits.(key).description string La descripción de la auditoría.
lighthouseResult.audits.(key).score nested object
lighthouseResult.audits.(key).scoreDisplayMode string El modo de visualización de puntuación enumerada.

Los valores aceptables son los siguientes:
  • "SCORE_DISPLAY_MODE_UNSPECIFIED"
  • "binary"
  • "error"
  • "informative"
  • "manual"
  • "not_applicable"
  • "numeric"
lighthouseResult.audits.(key).displayValue string Es el valor que se debe mostrar en la IU para esta auditoría.
lighthouseResult.audits.(key).explanation string Una explicación de los errores en la auditoría.
lighthouseResult.audits.(key).errorMessage string Un mensaje de error arrojado dentro de la auditoría.
lighthouseResult.audits.(key).warnings nested object
lighthouseResult.audits.(key).details object Sección de detalles en formato libre de la auditoría.
lighthouseResult.audits.(key).details.(key) any value
lighthouseResult.categories object Mapa de categorías en el LHR
lighthouseResult.categories.(key) nested object
lighthouseResult.categories.(key).id string Es el identificador de string de la categoría.
lighthouseResult.categories.(key).title string El nombre descriptivo de la categoría
lighthouseResult.categories.(key).description string Una descripción más detallada de la categoría y su importancia.
lighthouseResult.categories.(key).score nested object
lighthouseResult.categories.(key).manualDescription string Una descripción de las auditorías manuales en la categoría.
lighthouseResult.categories.(key).auditRefs[] list Un array de referencias a todos los miembros de auditoría de esta categoría.
lighthouseResult.categories.(key).auditRefs[].id string Es el ID de referencia de auditoría.
lighthouseResult.categories.(key).auditRefs[].weight double El peso que tiene la puntuación de esta auditoría sobre la puntuación general de la categoría.
lighthouseResult.categories.(key).auditRefs[].group string El grupo de categorías al que pertenece la auditoría (opcional).
lighthouseResult.categoryGroups object Mapa de grupos de categorías en el LHR
lighthouseResult.categoryGroups.(key) object
lighthouseResult.categoryGroups.(key).title string
lighthouseResult.categoryGroups.(key).description string
lighthouseResult.runtimeError object Objeto que contiene el código y el mensaje de cualquier error de entorno de ejecución arrojado.
lighthouseResult.runtimeError.code string

Los valores aceptables son los siguientes:
  • "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 Información de sincronización para este LHR.
lighthouseResult.timing.total double La duración total de la ejecución de Lighthouse
lighthouseResult.i18n object Las cadenas de internacionalización necesarias para renderizar el 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

Pruébala

Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en tiempo real y ver la respuesta.