对位于指定网址的网页运行 PageSpeed 分析,并返回 PageSpeed 得分、关于如何提升网页速度的建议列表以及其他信息。
HTTP 请求
GET https://pagespeedonline.googleapis.com/pagespeedonline/v5/runPagespeed
网址采用 gRPC 转码语法。
查询参数
参数 | |
---|---|
category |
要运行的 Lighthouse 类别;如果未指定任何类别,将仅运行“性能”类别 |
locale |
用于本地化格式化结果的语言区域 |
strategy |
要使用的分析策略(桌面设备或移动设备),桌面设备是默认策略 |
url |
必需。要提取和分析的网址 |
utm_campaign |
用于分析的广告系列名称。 |
utm_source |
广告系列分析来源。 |
captchaToken |
填写人机识别系统时传递的人机识别系统令牌。 |
请求正文
请求正文必须为空。
响应正文
如果成功,响应正文将包含结构如下的数据:
Pagespeed API 响应对象。
JSON 表示法 | |
---|---|
{ "kind": string, "captchaResult": string, "id": string, "loadingExperience": { object ( |
字段 | |
---|---|
kind |
结果的种类。 |
captchaResult |
人机识别系统验证结果 |
id |
经过页面重定向(如有)之后,文档的规范化最终到达网址和最终到达网址。 |
loadingExperience |
衡量最终用户网页加载体验的指标。 |
originLoadingExperience |
来源汇总网页加载体验的指标 |
analysisUTCTimestamp |
此分析的世界协调时间 (UTC) 时间戳。 |
lighthouseResult |
作为对象将审核网址 Lighthouse 响应。 |
version |
用于生成这些结果的 PageSpeed 的版本。 |
授权范围
需要以下 OAuth 作用域:
openid
有关详情,请参阅 OAuth 2.0 概览。
类别
应分析的枚举类别。
枚举 | |
---|---|
CATEGORY_UNSPECIFIED |
默认的“UNDEFINED”类别。 |
ACCESSIBILITY |
无障碍功能 (a11y),表示网站可供所有用户访问的容量的类别。 |
BEST_PRACTICES |
最佳实践,即网站对网络最佳实践的遵循情况的类别。 |
PERFORMANCE |
性能,与网站性能相关的类别。 |
SEO |
搜索引擎优化 (SEO),一种与网站能否被搜索引擎编入索引有关的类别。 |
策略
要在分析中使用的设备运行策略。
枚举 | |
---|---|
STRATEGY_UNSPECIFIED |
UNDEFINED。 |
DESKTOP |
提取并分析桌面浏览器的网址。 |
MOBILE |
提取并分析移动设备的网址。 |
PagespeedApiLoadingExperienceV5
包含 CrUX 数据细分的 CrUX 加载体验对象。
JSON 表示法 | |
---|---|
{
"id": string,
"metrics": {
string: {
object ( |
字段 | |
---|---|
id |
指标所在的网址、格式或来源。 |
metrics |
<metrics, data> 的映射。 包含一系列 |
overall_category |
ID 的人类可读速度“类别”。 |
initial_url |
请求的网址,可能与解析的“id”不同。 |
origin_fallback |
如果结果是来自网页的源站后备,则返回 true,否则返回 false。 |
LighthouseResultV5
Lighthouse 结果对象。
JSON 表示法 | |
---|---|
{ "fetchTime": string, "requestedUrl": string, "finalUrl": string, "lighthouseVersion": string, "i18n": { object ( |
字段 | |
---|---|
fetchTime |
提取此运行作业的时间。 |
requestedUrl |
请求的原始网址。 |
finalUrl |
经审核的最终已解析网址。 |
lighthouseVersion |
用于生成此 LHR 的灯塔版本。 |
i18n |
呈现 LHR 所需的国际化字符串。 |
userAgent |
用于运行此 LHR 的用户代理。 |
audits |
LHR 中审核的地图。 包含一系列 |
categoryGroups |
LHR 中类别组的地图。 包含一系列 |
stackPacks[] |
堆栈包建议字符串。 |
environment |
进行此 LHR 时使用的环境设置。 |
runWarnings |
LHR 中所有运行警告的列表。将始终输出到至少 |
runtimeError |
顶级错误消息(如果存在)表示存在足够严重的问题,导致此 Lighthouse 结果可能需要被舍弃。 |
categories |
LHR 中类别的地图。 |
timing |
此 LHR 的时间信息。 |
configSettings |
此 LHR 的配置设置。 |
本地化
包含 LHR - 版本 1 的国际化数据的消息。
JSON 表示法 | |
---|---|
{
"rendererFormattedStrings": {
object ( |
字段 | |
---|---|
rendererFormattedStrings |
国际化字符串,采用 configSettings 中的语言区域格式。 |
RendererFormattedStrings
包含渲染程序中使用的格式化字符串的消息。
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 } |
字段 | |
---|---|
varianceDisclaimer |
显示在效果指标值下方的免责声明。 |
opportunityResourceColumnLabel |
审核预计可节省页面加载次数的机会的标题。 |
opportunitySavingsColumnLabel |
机会审核预计可节省的网页加载次数的标题。 |
errorMissingAuditInfo |
错误审核旁边显示的错误字符串。 |
errorLabel |
出现错误的审核或指标旁边显示的标签。 |
warningHeader |
带项目符号的警告列表上方显示的标签。 |
auditGroupExpandTooltip |
可展开的 V 形图标上的提示文本。 |
passedAuditsGroupTitle |
通过的审核列表上方显示的标题。 |
notApplicableAuditsGroupTitle |
不适用于网页的审核列表上方显示的标题。 |
manualAuditsGroupTitle |
上方显示的标题列出了运行期间并非由计算机控制的审核。 |
toplevelWarningsMessage |
重要警告前面显示的标签,可能导致整个报告失效。 |
scorescaleLabel |
用于说明得分量表(0-49、50-89、90-100)的标签。 |
crcLongestDurationLabel |
关键请求链摘要中显示的值的标签。 |
crcInitialNavigation |
关键请求链中初始请求的标签。 |
lsPerformanceCategoryDescription |
广告效果下方显示的免责声明,用于说明广告网络可能会发生变化。 |
labDataTitle |
实验数据性能类别的标题。 |
StackPack
包含堆栈包信息的消息。
JSON 表示法 | |
---|---|
{ "id": string, "title": string, "iconDataURL": string, "descriptions": { string: string, ... } } |
字段 | |
---|---|
id |
堆栈包 ID。 |
title |
堆栈包标题。 |
iconDataURL |
堆栈图标数据 URI。 |
descriptions |
堆栈包建议字符串。 包含一系列 |
环境
包含 Lighthouse 运行的环境配置的消息。
JSON 表示法 | |
---|---|
{ "networkUserAgent": string, "hostUserAgent": string, "benchmarkIndex": number } |
字段 | |
---|---|
networkUserAgent |
通过网络发送的用户代理字符串。 |
hostUserAgent |
所用 Chrome 版本的用户代理字符串。 |
benchmarkIndex |
表示粗略设备类别的基准索引编号。 |
RuntimeError
包含运行时错误配置的消息。
JSON 表示法 | |
---|---|
{ "code": string, "message": string } |
字段 | |
---|---|
code |
枚举的 Lighthouse 错误代码。 |
message |
用于说明错误代码的人类可读消息。 |
类别
Lighthouse 运行中的类别。
JSON 表示法 | |
---|---|
{ "accessibility": { object ( |
字段 | |
---|---|
accessibility |
无障碍功能类别,包含所有与无障碍功能相关的审核。 |
best-practices |
最佳实践类别,包含所有与最佳实践相关的审核。 |
seo |
搜索引擎优化 (SEO) 类别,包含所有 SEO 相关审计。 |
performance |
性能类别,包含所有与性能相关的评估。 |
LighthouseCategoryV5
Lighthouse 类别。
JSON 表示法 | |
---|---|
{
"id": string,
"title": string,
"description": string,
"manualDescription": string,
"auditRefs": [
{
object ( |
字段 | |
---|---|
id |
类别的字符串标识符。 |
title |
直观易懂的类别名称。 |
description |
对类别及其重要性的详细说明。 |
manualDescription |
对该类别中的手动审核的说明。 |
auditRefs[] |
引用此类别的所有审核成员的数组。 |
score |
相应奖项类别的总体分数,即其所有评估结果的加权平均值。(类别的得分可以为 null。) |
AuditRefs
按 ID 对审核的浅引用,用于对指定类别中的审核进行分组和加权。
JSON 表示法 | |
---|---|
{ "id": string, "weight": number, "group": string } |
字段 | |
---|---|
id |
审核参考 ID。 |
weight |
此项评估的得分在总体类别得分中所占的权重。 |
group |
审核所属的类别群组(可选)。 |
计时
包含 Lighthouse 运行的性能时间数据的消息。
JSON 表示法 | |
---|---|
{ "total": number } |
字段 | |
---|---|
total |
Lighthouse 运行的总时长。 |
ConfigSettings
包含 Lighthouse 运行配置设置的消息。
JSON 表示法 | |
---|---|
{ "onlyCategories": value, "emulatedFormFactor": string, "locale": string, "channel": string, "formFactor": string } |
字段 | |
---|---|
onlyCategories |
运行过程中应执行的审核类别列表。 |
emulatedFormFactor |
模拟应使用的外形规格。此字段已弃用,应改用 formFactor。 |
locale |
语言区域设置。 |
channel |
Lighthouse 的运行方式,例如从 Chrome 扩展程序或 npm 模块运行。 |
formFactor |
在对性能指标评分和跳过桌面设备中专门针对移动设备的测试方面,Lighthouse 应如何解读此次运行。 |
PagespeedVersion
Pagespeed Version 对象。
JSON 表示法 | |
---|---|
{ "major": string, "minor": string } |
字段 | |
---|---|
major |
用于生成这些结果的 PageSpeed 的主要版本号。 |
minor |
用于生成这些结果的 PageSpeed 的次要版本号。 |