Menjalankan analisis PageSpeed pada halaman pada URL yang ditentukan, dan menampilkan skor PageSpeed, daftar saran untuk membuat halaman tersebut lebih cepat, serta informasi lainnya.
Permintaan HTTP
GET https://pagespeedonline.googleapis.com/pagespeedonline/v5/runPagespeed
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
category |
Kategori Lighthouse yang akan dijalankan; jika tidak ada yang diberikan, hanya kategori Performa yang akan dijalankan |
locale |
Lokalitas yang digunakan untuk melokalkan hasil yang diformat |
strategy |
Strategi analisis (desktop atau seluler) yang akan digunakan, dan desktop merupakan opsi default |
url |
Wajib. URL untuk diambil dan dianalisis |
utm_campaign |
Nama kampanye untuk analisis. |
utm_source |
Sumber kampanye untuk analisis. |
captchaToken |
Token reCAPTCHA diteruskan saat mengisi capta. |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Objek respons Pagespeed API.
Representasi JSON | |
---|---|
{ "kind": string, "captchaResult": string, "id": string, "loadingExperience": { object ( |
Kolom | |
---|---|
kind |
Semacam hasil. |
captchaResult |
Hasil verifikasi CAPTCHA |
id |
URL final dan kanonikalisasi untuk dokumen, setelah mengikuti pengalihan halaman (jika ada). |
loadingExperience |
Metrik pengalaman pemuatan halaman pengguna akhir. |
originLoadingExperience |
Metrik pengalaman pemuatan halaman gabungan dari situs asal |
analysisUTCTimestamp |
Stempel waktu UTC analisis ini. |
lighthouseResult |
Respons Lighthouse untuk URL audit sebagai objek. |
version |
Versi PageSpeed yang digunakan untuk menghasilkan hasil ini. |
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut ini:
openid
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
Kategori
Kategori terenumerasi yang harus dianalisis.
Enum | |
---|---|
CATEGORY_UNSPECIFIED |
Kategori default TIDAK DITENTUKAN. |
ACCESSIBILITY |
Aksesibilitas (a11y), kategori yang berkaitan dengan kapasitas situs untuk dapat diakses oleh semua pengguna. |
BEST_PRACTICES |
Praktik Terbaik, yaitu kategori yang berkaitan dengan kesesuaian situs dengan praktik terbaik web. |
PERFORMANCE |
Performa, kategori yang berkaitan dengan performa situs. |
SEO |
Pengoptimalan Mesin Telusur (SEO), kategori yang berkaitan dengan kemampuan situs untuk diindeks oleh mesin telusur. |
Strategi
Strategi pengoperasian perangkat yang akan digunakan dalam analisis.
Enum | |
---|---|
STRATEGY_UNSPECIFIED |
TIDAK DITENTUKAN. |
DESKTOP |
Mengambil dan menganalisis URL untuk browser desktop. |
MOBILE |
Mengambil dan menganalisis URL untuk perangkat seluler. |
PagespeedApiLoadingExperienceV5
Objek pengalaman pemuatan CrUX yang berisi perincian data CrUX.
Representasi JSON | |
---|---|
{
"id": string,
"metrics": {
string: {
object ( |
Kolom | |
---|---|
id |
URL, pola, atau asal tempat metrik berada. |
metrics |
Peta <metrics, data>. Objek yang berisi daftar pasangan |
overall_category |
Kecepatan "kategori" ID yang dapat dibaca manusia. |
initial_url |
URL yang diminta, yang mungkin berbeda dengan "id" yang telah di-resolve. |
origin_fallback |
Benar jika hasilnya adalah penggantian origin dari halaman, false jika tidak. |
LighthouseResultV5
Objek hasil Lighthouse.
Representasi JSON | |
---|---|
{ "fetchTime": string, "requestedUrl": string, "finalUrl": string, "lighthouseVersion": string, "i18n": { object ( |
Kolom | |
---|---|
fetchTime |
Waktu pengambilan data ini. |
requestedUrl |
URL asli yang diminta. |
finalUrl |
URL final yang diselesaikan dan diaudit. |
lighthouseVersion |
Versi mercusuar yang digunakan untuk menghasilkan LHR ini. |
i18n |
String internasionalisasi yang diperlukan untuk merender LHR. |
userAgent |
Agen pengguna yang digunakan untuk menjalankan LHR ini. |
audits |
Peta audit di LHR. Objek yang berisi daftar pasangan |
categoryGroups |
Peta grup kategori di LHR. Objek yang berisi daftar pasangan |
stackPacks[] |
String saran Stack Pack. |
environment |
Setelan lingkungan yang digunakan saat membuat LHR ini. |
runWarnings |
Daftar semua peringatan operasi di LHR. Akan selalu menghasilkan output minimal ke |
runtimeError |
Pesan error tingkat atas yang, jika ada, menunjukkan masalah yang cukup serius sehingga hasil Lighthouse ini mungkin perlu dihapus. |
categories |
Peta kategori di LHR. |
timing |
Informasi pengaturan waktu untuk LHR ini. |
configSettings |
Setelan konfigurasi untuk LHR ini. |
I18n
Pesan berisi data i18n untuk LHR - Versi 1.
Representasi JSON | |
---|---|
{
"rendererFormattedStrings": {
object ( |
Kolom | |
---|---|
rendererFormattedStrings |
String internasional yang diformat ke lokalitas di configSettings. |
RendererFormattedStrings
Pesan berisi string berformat yang digunakan dalam perender.
Representasi 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 } |
Kolom | |
---|---|
varianceDisclaimer |
Pernyataan penyangkalan ditampilkan di bawah nilai metrik performa. |
opportunityResourceColumnLabel |
Judul untuk estimasi peluang penghematan pemuatan halaman dari audit. |
opportunitySavingsColumnLabel |
Judul untuk estimasi penghematan pemuatan halaman dari audit peluang. |
errorMissingAuditInfo |
String error yang ditampilkan di samping audit yang mengalami error. |
errorLabel |
Label yang ditampilkan di samping audit atau metrik yang memiliki error. |
warningHeader |
Label yang ditampilkan di atas daftar berbutir peringatan. |
auditGroupExpandTooltip |
Teks tooltip pada ikon tanda V yang dapat diluaskan. |
passedAuditsGroupTitle |
Judul yang ditampilkan di atas daftar audit yang lulus. |
notApplicableAuditsGroupTitle |
Judul yang ditampilkan di atas daftar audit yang tidak berlaku untuk suatu halaman. |
manualAuditsGroupTitle |
Judul yang ditunjukkan di atas daftar audit yang tidak dijalankan dengan komputer. |
toplevelWarningsMessage |
Label ditampilkan sebelum peringatan penting yang mungkin telah membuat seluruh laporan tidak valid. |
scorescaleLabel |
Label yang menjelaskan skor mengukur skala (0-49, 50-89, 90-100). |
crcLongestDurationLabel |
Label untuk nilai yang ditampilkan dalam ringkasan rantai permintaan penting. |
crcInitialNavigation |
Label untuk permintaan awal dalam rantai permintaan penting. |
lsPerformanceCategoryDescription |
Pernyataan penyangkalan ditampilkan di bagian performa yang menjelaskan bahwa jaringan dapat bervariasi. |
labDataTitle |
Judul kategori performa data lab. |
StackPack
Pesan yang berisi informasi Paket Tumpukan.
Representasi JSON | |
---|---|
{ "id": string, "title": string, "iconDataURL": string, "descriptions": { string: string, ... } } |
Kolom | |
---|---|
id |
ID paket stack. |
title |
Judul paket tumpukan. |
iconDataURL |
URI data ikon paket tumpukan. |
descriptions |
String saran paket stack. Objek yang berisi daftar pasangan |
Lingkungan
Pesan yang berisi konfigurasi lingkungan untuk menjalankan Lighthouse.
Representasi JSON | |
---|---|
{ "networkUserAgent": string, "hostUserAgent": string, "benchmarkIndex": number } |
Kolom | |
---|---|
networkUserAgent |
String agen pengguna yang dikirim melalui jaringan. |
hostUserAgent |
String agen pengguna versi Chrome yang digunakan. |
benchmarkIndex |
Nomor indeks benchmark yang menunjukkan kasar class perangkat. |
RuntimeError
Pesan yang berisi konfigurasi error runtime.
Representasi JSON | |
---|---|
{ "code": string, "message": string } |
Kolom | |
---|---|
code |
Kode Error Lighthouse yang dienumerasi. |
message |
Pesan yang dapat dibaca manusia yang menjelaskan kode error. |
Kategori
Kategori dalam run Lighthouse.
Representasi JSON | |
---|---|
{ "accessibility": { object ( |
Kolom | |
---|---|
accessibility |
Kategori aksesibilitas, yang berisi semua audit terkait aksesibilitas. |
best-practices |
Kategori praktik terbaik, yang berisi semua audit terkait praktik terbaik. |
seo |
Kategori Pengoptimalan Mesin Telusur (SEO), yang berisi semua audit terkait SEO. |
performance |
Kategori performa, yang berisi semua audit terkait performa. |
LighthouseCategoryV5
Kategori Lighthouse.
Representasi JSON | |
---|---|
{
"id": string,
"title": string,
"description": string,
"manualDescription": string,
"auditRefs": [
{
object ( |
Kolom | |
---|---|
id |
ID string kategori. |
title |
Nama kategori yang mudah dibaca manusia. |
description |
Deskripsi yang lebih rinci tentang kategori dan nilai pentingnya. |
manualDescription |
Deskripsi untuk audit manual dalam kategori. |
auditRefs[] |
Array referensi ke semua anggota audit kategori ini. |
score |
Skor keseluruhan kategori, rata-rata tertimbang dari semua auditnya. (Skor kategori, boleh null.) |
AuditRefs
Referensi ringan ke audit menurut ID, yang digunakan untuk mengelompokkan dan bobot audit dalam kategori tertentu.
Representasi JSON | |
---|---|
{ "id": string, "weight": number, "group": string } |
Kolom | |
---|---|
id |
ID referensi audit. |
weight |
Bobot yang dimiliki skor audit ini terhadap skor kategori keseluruhan. |
group |
Grup kategori tempat audit berada (opsional). |
Waktu
Pesan yang berisi data waktu performa untuk menjalankan Lighthouse.
Representasi JSON | |
---|---|
{ "total": number } |
Kolom | |
---|---|
total |
Total durasi perjalanan Lighthouse. |
ConfigSettings
Pesan yang berisi setelan konfigurasi untuk menjalankan Lighthouse.
Representasi JSON | |
---|---|
{ "onlyCategories": value, "emulatedFormFactor": string, "locale": string, "channel": string, "formFactor": string } |
Kolom | |
---|---|
onlyCategories |
Daftar kategori audit yang harus dilakukan oleh perusahaan tersebut. |
emulatedFormFactor |
Faktor bentuk yang harus digunakan emulasi. Kolom ini tidak digunakan lagi. Sebagai gantinya, formFactor harus digunakan. |
locale |
Setelan lokalitas. |
channel |
Cara Lighthouse dijalankan, misalnya dari ekstensi Chrome atau dari modul npm. |
formFactor |
Bagaimana Lighthouse seharusnya menafsirkan proses ini dalam hal penilaian metrik performa dan melewatkan pengujian khusus seluler di desktop. |
PagespeedVersion
Objek Pagespeed Version.
Representasi JSON | |
---|---|
{ "major": string, "minor": string } |
Kolom | |
---|---|
major |
Nomor versi utama PageSpeed yang digunakan untuk menghasilkan hasil ini. |
minor |
Nomor versi minor PageSpeed yang digunakan untuk menghasilkan hasil ini. |