เรียกใช้การวิเคราะห์ PageSpeed ในหน้าเว็บที่ URL ที่ระบุ และแสดงคะแนน PageSpeed รายการคำแนะนำในการทำให้หน้าเว็บนั้นเร็วขึ้น และข้อมูลอื่นๆ ลองใช้เลย
ส่งคำขอ
คำขอ HTTP
GET https://www.googleapis.com/pagespeedonline/v5/runPagespeed
พารามิเตอร์
| ชื่อพารามิเตอร์ | ค่า | คำอธิบาย |
|---|---|---|
| พารามิเตอร์การค้นหาที่จำเป็น | ||
url |
string |
URL ที่จะดึงข้อมูลและวิเคราะห์ |
| พารามิเตอร์การค้นหาที่ไม่บังคับ | ||
category |
string |
หมวดหมู่ Lighthouse ที่จะเรียกใช้ หากไม่ได้ระบุ ระบบจะเรียกใช้เฉพาะหมวดหมู่ประสิทธิภาพ
ค่าที่ยอมรับได้มีดังนี้
|
locale |
string |
ภาษาที่ใช้ในการแปลผลการค้นหาที่จัดรูปแบบ |
strategy |
string |
กลยุทธ์การวิเคราะห์ (เดสก์ท็อปหรืออุปกรณ์เคลื่อนที่) ที่จะใช้ และเดสก์ท็อปเป็นค่าเริ่มต้น
ค่าที่ยอมรับได้มีดังนี้
|
utm_campaign |
string |
ชื่อแคมเปญสําหรับ Analytics |
utm_source |
string |
แหล่งที่มาของแคมเปญสําหรับ Analytics |
เนื้อความของคำขอ
อย่าระบุเนื้อหาคำขอด้วยเมธอดนี้
การตอบกลับ
หากทำสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับที่มีโครงสร้างดังต่อไปนี้
{
"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
}
}| ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
|---|---|---|---|
captchaResult |
string |
ผลการยืนยันแคปต์ชา
ค่าที่ยอมรับมีดังนี้
|
|
kind |
string |
ประเภทผลการค้นหา | |
id |
string |
Canonical URL และ URL สุดท้ายของเอกสารหลังจากติดตามการเปลี่ยนเส้นทางของหน้าเว็บ (หากมี) | |
loadingExperience |
nested object |
เมตริกของประสบการณ์การโหลดหน้าเว็บของผู้ใช้ปลายทาง | |
loadingExperience.id |
string |
URL, รูปแบบ หรือต้นทางที่เมตริกอยู่ | |
loadingExperience.metrics |
object |
||
loadingExperience.metrics.(key) |
object |
ประเภทของเมตริก | |
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 |
เวอร์ชันของ PageSpeed ที่ใช้สร้างผลลัพธ์เหล่านี้ | |
version.major |
integer |
หมายเลขเวอร์ชันหลักของ PageSpeed ที่ใช้สร้างผลลัพธ์เหล่านี้ | |
version.minor |
integer |
หมายเลขเวอร์ชันย่อยของ PageSpeed ที่ใช้ในการสร้างผลลัพธ์เหล่านี้ | |
loadingExperience.metrics.(key).category |
string |
ค่าที่ยอมรับมีดังนี้
|
|
loadingExperience.overall_category |
string |
ค่าที่ยอมรับมีดังนี้
|
|
loadingExperience.initial_url |
string |
||
loadingExperience.metrics.(key).percentile |
integer |
||
originLoadingExperience |
nested object |
เมตริกของประสบการณ์การโหลดหน้าเว็บแบบรวมของต้นทาง | |
originLoadingExperience.id |
string |
URL, รูปแบบ หรือต้นทางที่เมตริกอยู่ | |
originLoadingExperience.metrics |
object |
||
originLoadingExperience.metrics.(key) |
object |
ประเภทของเมตริก | |
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 |
ค่าที่ยอมรับมีดังนี้
|
|
originLoadingExperience.overall_category |
string |
ค่าที่ยอมรับมีดังนี้
|
|
originLoadingExperience.initial_url |
string |
||
analysisUTCTimestamp |
string |
การประทับเวลา UTC ของการวิเคราะห์นี้ | |
lighthouseResult |
nested object |
การตอบกลับของ Lighthouse สำหรับ URL การตรวจสอบเป็นออบเจ็กต์ | |
lighthouseResult.requestedUrl |
string |
URL เดิมที่ขอ | |
lighthouseResult.finalUrl |
string |
URL สุดท้ายที่แก้ไขแล้วซึ่งได้รับการตรวจสอบ | |
lighthouseResult.lighthouseVersion |
string |
เวอร์ชัน Lighthouse ที่ใช้สร้าง LHR นี้ | |
lighthouseResult.userAgent |
string |
User Agent ที่ใช้เรียกใช้ LHR นี้ | |
lighthouseResult.fetchTime |
string |
เวลาที่ดึงข้อมูลการเรียกใช้นี้ | |
lighthouseResult.environment |
object |
การตั้งค่าสภาพแวดล้อมที่ใช้เมื่อสร้าง LHR นี้ | |
lighthouseResult.environment.networkUserAgent |
string |
||
lighthouseResult.environment.hostUserAgent |
string |
||
lighthouseResult.environment.benchmarkIndex |
double |
||
lighthouseResult.runWarnings[] |
list |
รายการคำเตือนทั้งหมดที่เรียกใช้ใน LHR จะแสดงผลเป็น `[]` เสมอ | |
lighthouseResult.configSettings |
object |
การตั้งค่าการกำหนดค่าสำหรับ LHR นี้ | |
lighthouseResult.configSettings.emulatedFormFactor |
string |
รูปแบบของอุปกรณ์ที่การจำลองควรใช้
ค่าที่ยอมรับได้มีดังนี้
|
|
lighthouseResult.configSettings.locale |
string |
การตั้งค่าภาษา | |
lighthouseResult.configSettings.onlyCategories |
nested object |
||
lighthouseResult.audits |
object |
แผนที่การตรวจสอบใน LHR | |
lighthouseResult.audits.(key) |
nested object |
||
lighthouseResult.audits.(key).id |
string |
รหัสของการตรวจสอบ | |
lighthouseResult.audits.(key).title |
string |
ชื่อที่มนุษย์อ่านได้ | |
lighthouseResult.audits.(key).description |
string |
คำอธิบายของการตรวจสอบ | |
lighthouseResult.audits.(key).score |
nested object |
||
lighthouseResult.audits.(key).scoreDisplayMode |
string |
โหมดการแสดงคะแนนแบบแจงนับ
ค่าที่ยอมรับมีดังนี้
|
|
lighthouseResult.audits.(key).displayValue |
string |
ค่าที่ควรแสดงใน UI สำหรับการตรวจสอบนี้ | |
lighthouseResult.audits.(key).explanation |
string |
คำอธิบายข้อผิดพลาดในการตรวจสอบ | |
lighthouseResult.audits.(key).errorMessage |
string |
ข้อความแสดงข้อผิดพลาดจากข้อผิดพลาดที่เกิดขึ้นภายในบันทึกการตรวจสอบ | |
lighthouseResult.audits.(key).warnings |
nested object |
||
lighthouseResult.audits.(key).details |
object |
ส่วนรายละเอียดของ Freeform ในการตรวจสอบ | |
lighthouseResult.audits.(key).details.(key) |
any value |
||
lighthouseResult.categories |
object |
แผนที่หมวดหมู่ใน LHR | |
lighthouseResult.categories.(key) |
nested object |
||
lighthouseResult.categories.(key).id |
string |
ตัวระบุสตริงของหมวดหมู่ | |
lighthouseResult.categories.(key).title |
string |
ชื่อหมวดหมู่ที่อ่านง่าย | |
lighthouseResult.categories.(key).description |
string |
คำอธิบายโดยละเอียดของหมวดหมู่และความสำคัญ | |
lighthouseResult.categories.(key).score |
nested object |
||
lighthouseResult.categories.(key).manualDescription |
string |
คำอธิบายสำหรับการตรวจสอบด้วยตนเองในหมวดหมู่ | |
lighthouseResult.categories.(key).auditRefs[] |
list |
อาร์เรย์ของการอ้างอิงถึงสมาชิกทั้งหมดในการตรวจสอบของหมวดหมู่นี้ | |
lighthouseResult.categories.(key).auditRefs[].id |
string |
รหัสอ้างอิงการตรวจสอบ | |
lighthouseResult.categories.(key).auditRefs[].weight |
double |
น้ำหนักที่คะแนนการตรวจสอบนี้มีต่อคะแนนหมวดหมู่โดยรวม | |
lighthouseResult.categories.(key).auditRefs[].group |
string |
กลุ่มหมวดหมู่ที่การตรวจสอบเป็นของ (ไม่บังคับ) | |
lighthouseResult.categoryGroups |
object |
แผนที่กลุ่มหมวดหมู่ใน LHR | |
lighthouseResult.categoryGroups.(key) |
object |
||
lighthouseResult.categoryGroups.(key).title |
string |
||
lighthouseResult.categoryGroups.(key).description |
string |
||
lighthouseResult.runtimeError |
object |
ออบเจ็กต์ที่มีรหัส + ข้อความของข้อผิดพลาดรันไทม์ที่เกิดขึ้น | |
lighthouseResult.runtimeError.code |
string |
ค่าที่ยอมรับมีดังนี้
|
|
lighthouseResult.runtimeError.message |
string |
||
lighthouseResult.timing |
object |
ข้อมูลเวลาสำหรับ LHR นี้ | |
lighthouseResult.timing.total |
double |
ระยะเวลาทั้งหมดของการเรียกใช้ Lighthouse | |
lighthouseResult.i18n |
object |
สตริงการทำให้เป็นสากลที่จำเป็นต่อการแสดงผล 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 |
ลองใช้งาน
ใช้โปรแกรมสำรวจ API ด้านล่างเพื่อเรียกเมธอดนี้ในข้อมูลสดและดูการตอบกลับ