Pagespeedapi: runpagespeed

Ejecuta PageSpeed Analysis en la página de la URL especificada y muestra las puntuaciones de PageSpeed, una lista de sugerencias para hacer que esa página sea más rápida, entre otros datos. 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 para 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 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 usará y las computadoras de escritorio son la opción predeterminada.

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

Cuerpo de la solicitud

No proporciones un cuerpo de la 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 URL final canónica y final del documento, después de los redireccionamientos de página siguientes (si los hubiera).
loadingExperience nested object Métricas de las métricas de carga de página.
loadingExperience.id string La URL, el patrón o el origen en el que se encuentran las métricas.
loadingExperience.metrics object
loadingExperience.metrics.(key) object 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 Indica el número de versión principal de PageSpeed que se utiliza para generar estos resultados.
version.minor integer Indica el número de versión secundaria de PageSpeed que se utiliza 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 el que se encuentran las métricas.
originLoadingExperience.metrics object
originLoadingExperience.metrics.(key) object 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 La URL original solicitada.
lighthouseResult.finalUrl string La URL final resuelta que se auditó.
lighthouseResult.lighthouseVersion string Es la versión de 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. El resultado siempre será, al menos, `[]`.
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 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 por humanos.
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 puntuaciones enumeradas.

Los valores aceptables son los siguientes:
  • "SCORE_DISPLAY_MODE_UNSPECIFIED"
  • "binary"
  • "error"
  • "informative"
  • "manual"
  • "not_applicable"
  • "numeric"
lighthouseResult.audits.(key).displayValue string 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 de un 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 cadena de la categoría.
lighthouseResult.categories.(key).title string Es el nombre sencillo 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 la auditoría de esta categoría.
lighthouseResult.categories.(key).auditRefs[].id string El ID de referencia de auditoría
lighthouseResult.categories.(key).auditRefs[].weight double La ponderación de la puntuación de esta auditoría en la puntuación general de la categoría.
lighthouseResult.categories.(key).auditRefs[].group string La categoría del grupo al que pertenece la auditoría (opcional).
lighthouseResult.categoryGroups object Mapa de los 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 horarios para este LHR.
lighthouseResult.timing.total double Duración total de la ejecución de Lighthouse
lighthouseResult.i18n object Las cadenas de internacionalización que se requieren para procesar 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ébalo

Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.