Menjalankan analisis PageSpeed pada halaman pada URL yang ditentukan, dan menampilkan skor PageSpeed, daftar saran untuk membuat halaman tersebut lebih cepat, serta informasi lainnya. Coba sekarang.
Permintaan
Permintaan HTTP
GET https://www.googleapis.com/pagespeedonline/v4/runPagespeed
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter kueri yang diperlukan | ||
url |
string |
URL untuk diambil dan dianalisis |
Parameter kueri opsional | ||
filter_third_party_resources |
boolean |
Menunjukkan apakah sumber daya pihak ketiga harus difilter sebelum analisis PageSpeed.
(Default: false )
|
locale |
string |
Lokalitas yang digunakan untuk melokalkan hasil berformat |
rule |
string |
Aturan PageSpeed untuk dijalankan; jika tidak ada yang diberikan, semua aturan akan dijalankan |
screenshot |
boolean |
Menunjukkan apakah data biner yang berisi screenshot harus disertakan
(Default: false )
|
snapshots |
boolean |
Menunjukkan apakah data biner yang berisi gambar snapshot harus disertakan
(Default: false )
|
strategy |
string |
Strategi analisis (desktop atau seluler) yang akan digunakan, dan desktop bersifat default
Nilai yang dapat diterima adalah:
|
utm_campaign |
string |
Nama kampanye untuk analisis. |
utm_source |
string |
Sumber kampanye untuk analisis. |
Isi permintaan
Jangan memberikan isi permintaan dengan metode ini.
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{ "captchaResult": string, "kind": "pagespeedonline#result", "id": string, "responseCode": integer, "title": string, "ruleGroups": { (key): { "score": integer, "pass": boolean } }, "loadingExperience": { "id": string, "metrics": { (key): { "median": integer, "distributions": [ { "min": integer, "max": integer, "proportion": double } ], "category": string } }, "overall_category": string, "initial_url": string }, "pageStats": { "numberResources": integer, "numberHosts": integer, "totalRequestBytes": long, "numberStaticResources": integer, "htmlResponseBytes": long, "textResponseBytes": long, "overTheWireResponseBytes": long, "cssResponseBytes": long, "imageResponseBytes": long, "javascriptResponseBytes": long, "flashResponseBytes": long, "otherResponseBytes": long, "numberJsResources": integer, "numberCssResources": integer, "numberRobotedResources": integer, "numberTransientFetchFailureResources": integer, "numTotalRoundTrips": integer, "numRenderBlockingRoundTrips": integer, "robotedUrls": [ string ], "transientFetchFailureUrls": [ string ], "cms": string }, "formattedResults": { "locale": string, "ruleResults": { (key): { "localizedRuleName": string, "ruleImpact": double, "beta": boolean, "groups": [ string ], "summary": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "urlBlocks": [ { "header": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "urls": [ { "result": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "details": [ { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] } ] } ] } ] } } }, "version": { "major": integer, "minor": integer }, "invalidRules": [ string ], "screenshot": { "key": string, "mime_type": string, "data": bytes, "width": integer, "height": integer, "page_rect": { "left": integer, "top": integer, "width": integer, "height": integer } }, "snapshots": [ { "key": string, "mime_type": string, "data": bytes, "width": integer, "height": integer, "page_rect": { "left": integer, "top": integer, "width": integer, "height": integer } } ] }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
captchaResult |
string |
Hasil verifikasi CAPTCHA
Nilai yang diterima adalah:
|
|
kind |
string |
Jenis hasil. | |
id |
string |
URL final dan kanonis untuk dokumen, setelah mengikuti pengalihan halaman (jika ada). | |
responseCode |
integer |
Kode respons untuk dokumen. 200 menunjukkan pemuatan halaman normal. 4xx/5xx menunjukkan error. | |
title |
string |
Judul halaman, seperti yang ditampilkan di kolom judul browser. | |
ruleGroups |
object |
Peta dengan satu entri untuk setiap grup aturan dalam hasil ini. | |
ruleGroups.(key) |
object |
Nama grup aturan ini: salah satu dari "SPEED", "USABILITY", atau "security". | |
ruleGroups.(key).score |
integer |
Skor (0-100) untuk grup aturan ini, yang menunjukkan seberapa baik halaman bisa berada dalam kategori tersebut (mis. seberapa cepat, atau seberapa banyak manfaat yang lain, atau seberapa aman). Skor yang tinggi menunjukkan hanya sedikit yang harus ditingkatkan, sedangkan skor yang rendah menunjukkan masih banyak yang harus ditingkatkan. | |
ruleGroups.(key).pass |
boolean |
||
loadingExperience |
object |
Metrik pengalaman pemuatan halaman pengguna akhir. | |
loadingExperience.id |
string |
URL, pola, atau origin tempat metrik berada. | |
loadingExperience.metrics |
object |
||
loadingExperience.metrics.(key) |
object |
Jenis metrik. | |
loadingExperience.metrics.(key).median |
integer |
||
loadingExperience.metrics.(key).distributions[] |
list |
||
loadingExperience.metrics.(key).distributions[].min |
integer |
||
loadingExperience.metrics.(key).distributions[].max |
integer |
||
loadingExperience.metrics.(key).distributions[].proportion |
double |
||
pageStats |
object |
Statistik ringkasan untuk halaman, seperti jumlah byte JavaScript, jumlah byte HTML, dll. | |
pageStats.numberResources |
integer |
Jumlah resource HTTP yang dimuat oleh halaman. | |
pageStats.numberHosts |
integer |
Jumlah host unik yang dirujuk oleh halaman. | |
pageStats.totalRequestBytes |
long |
Ukuran total semua byte permintaan yang dikirim oleh halaman. | |
pageStats.numberStaticResources |
integer |
Jumlah resource statis (misalnya, dapat disimpan dalam cache) di halaman. | |
pageStats.htmlResponseBytes |
long |
Jumlah byte respons yang tidak dikompresi untuk dokumen HTML utama dan semua iframe pada halaman. | |
pageStats.textResponseBytes |
long |
Jumlah byte respons yang tidak dikompresi untuk resource teks yang tidak tercakup oleh statistik lain (yaitu resource non-HTML, non-skrip, non-CSS) di halaman. | |
pageStats.overTheWireResponseBytes |
long |
Jumlah byte melalui jaringan, menggunakan strategi kompresi gzip default sebagai estimasi. | |
pageStats.cssResponseBytes |
long |
Jumlah byte respons yang tidak dikompresi untuk resource CSS di halaman. | |
pageStats.imageResponseBytes |
long |
Jumlah byte respons untuk resource gambar di halaman. | |
pageStats.javascriptResponseBytes |
long |
Jumlah byte respons yang tidak dikompresi untuk resource JS di halaman. | |
pageStats.flashResponseBytes |
long |
Jumlah byte respons untuk resource flash pada halaman. | |
pageStats.otherResponseBytes |
long |
Jumlah byte respons untuk resource lain pada halaman. | |
pageStats.numberJsResources |
integer |
Jumlah resource JavaScript yang dirujuk oleh halaman. | |
pageStats.numberCssResources |
integer |
Jumlah resource CSS yang dirujuk oleh halaman. | |
pageStats.numberRobotedResources |
integer |
Jumlah resource yang dibatasi robot. | |
pageStats.numberTransientFetchFailureResources |
integer |
Jumlah resource yang gagal sementara. | |
pageStats.numTotalRoundTrips |
integer |
Perjalanan bolak-balik yang diperlukan untuk memuat halaman lengkap | |
pageStats.numRenderBlockingRoundTrips |
integer |
Round-trip yang diperlukan untuk memuat resource pemblokiran render | |
pageStats.robotedUrls[] |
list |
Daftar URL yang dibatasi robot. | |
pageStats.transientFetchFailureUrls[] |
list |
Daftar URL kegagalan pengambilan sementara. | |
pageStats.cms |
string |
Sistem pengelolaan konten (CMS) yang digunakan untuk halaman.
Nilai yang dapat diterima adalah:
|
|
formattedResults |
object |
Hasil PageSpeed yang dilokalkan. Berisi entri ruleResults untuk setiap aturan PageSpeed yang dibuat dan dijalankan oleh server. | |
formattedResults.locale |
string |
Lokalitas formattedResults, mis. "en_US". | |
formattedResults.ruleResults |
object |
Kamus hasil aturan yang diformat, dengan satu entri untuk setiap aturan PageSpeed yang dibuat dan dijalankan oleh server. | |
formattedResults.ruleResults.(key) |
object |
ID mirip enum untuk aturan ini. Misalnya "EnableKeepAlive" atau "HindariCssImport". Tidak dilokalkan. | |
formattedResults.ruleResults.(key).localizedRuleName |
string |
Nama aturan yang dilokalkan, yang ditujukan untuk presentasi kepada pengguna. | |
formattedResults.ruleResults.(key).ruleImpact |
double |
Dampak (nilai floating point tak terbatas) yang menerapkan saran untuk aturan ini akan membuat halaman menjadi lebih cepat. Dampaknya sebanding di antara aturan untuk menentukan saran aturan mana yang akan memiliki dampak yang lebih tinggi atau lebih rendah untuk membuat halaman lebih cepat. Misalnya, jika mengaktifkan kompresi akan menghemat 1 MB, sementara mengoptimalkan gambar akan menghemat 500 kB, aturan kompresi pengaktifan akan memiliki dampak 2x dari aturan pengoptimalan gambar, semua hal lainnya dianggap sama. | |
formattedResults.ruleResults.(key).beta |
boolean |
Apakah aturan ini dalam versi 'beta'. Aturan dalam versi beta adalah aturan baru yang sedang diuji, yang tidak memengaruhi skor keseluruhan. | |
formattedResults.ruleResults.(key).groups[] |
list |
Daftar grup aturan tempat aturan ini berada. Setiap entri dalam daftar adalah salah satu dari "KECEPATAN", "Kegunaan", atau "KEAMANAN". | |
formattedResults.ruleResults.(key).summary |
nested object |
Deskripsi ringkasan singkat untuk aturan, yang menunjukkan secara umum apa yang harus dilakukan untuk mematuhi aturan dan manfaat apa yang dapat diperoleh dengan melakukannya. | |
formattedResults.ruleResults.(key).summary.format |
string |
String format yang dilokalkan dengan placeholder , dengan 'FOO' adalah kunci argumen yang nilainya harus diganti. Untuk argumen HYPERLINK, string format akan berisi dan untuk argumen dengan kunci 'FOO'. | |
formattedResults.ruleResults.(key).summary.args[] |
list |
Daftar argumen untuk string format. | |
formattedResults.ruleResults.(key).summary.args[].type |
string |
Jenis argumen. Salah satu dari URL, STRING_LITERAL, INT_LITERAL, CURRENCY, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK, atau SNAPSHOT_RECT.
Nilai yang dapat diterima adalah:
|
|
formattedResults.ruleResults.(key).summary.args[].key |
string |
Kunci placeholder untuk argumen ini, sebagai string. | |
formattedResults.ruleResults.(key).summary.args[].value |
string |
Nilai argumen, sebagai string yang dilokalkan. | |
formattedResults.ruleResults.(key).summary.args[].rects[] |
list |
Persegi panjang layar yang dirujuk, dengan dimensi yang diukur dalam piksel CSS. Ini hanya digunakan untuk argumen SNAPSHOT_RECT. Jika ini tidak ada untuk argumen SNAPSHOT_RECT, berarti argumen tersebut merujuk ke seluruh snapshot. | |
formattedResults.ruleResults.(key).summary.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[] |
list |
Persegi panjang layar sekunder yang dirujuk, dengan dimensi yang diukur dalam piksel CSS. Ini hanya digunakan untuk argumen SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[] |
list |
Daftar blok URL. Setiap blok dapat berisi judul dan daftar URL. Setiap URL dapat menyertakan detail tambahan secara opsional. | |
formattedResults.ruleResults.(key).urlBlocks[].header |
nested object |
Judul yang akan ditampilkan bersama daftar URL. | |
formattedResults.ruleResults.(key).urlBlocks[].header.format |
string |
String format yang dilokalkan dengan placeholder , dengan 'FOO' adalah kunci argumen yang nilainya harus diganti. Untuk argumen HYPERLINK, string format akan berisi dan untuk argumen dengan kunci 'FOO'. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[] |
list |
Daftar argumen untuk string format. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].type |
string |
Jenis argumen. Salah satu dari URL, STRING_LITERAL, INT_LITERAL, CURRENCY, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK, atau SNAPSHOT_RECT.
Nilai yang dapat diterima adalah:
|
|
formattedResults.ruleResults.(key).urlBlocks[].header.args[].key |
string |
Kunci placeholder untuk argumen ini, sebagai string. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].value |
string |
Nilai argumen, sebagai string yang dilokalkan. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[] |
list |
Persegi panjang layar yang dirujuk, dengan dimensi yang diukur dalam piksel CSS. Ini hanya digunakan untuk argumen SNAPSHOT_RECT. Jika ini tidak ada untuk argumen SNAPSHOT_RECT, berarti argumen tersebut merujuk ke seluruh snapshot. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[] |
list |
Persegi panjang layar sekunder yang dirujuk, dengan dimensi yang diukur dalam piksel CSS. Ini hanya digunakan untuk argumen SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[] |
list |
Daftar entri yang memberikan informasi tentang URL dalam blok URL. Opsional. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result |
nested object |
String format yang memberikan informasi tentang URL, dan daftar argumen untuk string format tersebut. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.format |
string |
String format yang dilokalkan dengan placeholder , dengan 'FOO' adalah kunci argumen yang nilainya harus diganti. Untuk argumen HYPERLINK, string format akan berisi dan untuk argumen dengan kunci 'FOO'. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[] |
list |
Daftar argumen untuk string format. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].type |
string |
Jenis argumen. Salah satu dari URL, STRING_LITERAL, INT_LITERAL, CURRENCY, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK, atau SNAPSHOT_RECT.
Nilai yang dapat diterima adalah:
|
|
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].key |
string |
Kunci placeholder untuk argumen ini, sebagai string. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].value |
string |
Nilai argumen, sebagai string yang dilokalkan. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[] |
list |
Persegi panjang layar yang dirujuk, dengan dimensi yang diukur dalam piksel CSS. Ini hanya digunakan untuk argumen SNAPSHOT_RECT. Jika ini tidak ada untuk argumen SNAPSHOT_RECT, berarti argumen tersebut merujuk ke seluruh snapshot. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[] |
list |
Persegi panjang layar sekunder yang dirujuk, dengan dimensi yang diukur dalam piksel CSS. Ini hanya digunakan untuk argumen SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[] |
list |
Daftar entri yang memberikan detail tambahan tentang URL tunggal. Opsional. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].format |
string |
String format yang dilokalkan dengan placeholder , dengan 'FOO' adalah kunci argumen yang nilainya harus diganti. Untuk argumen HYPERLINK, string format akan berisi dan untuk argumen dengan kunci 'FOO'. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[] |
list |
Daftar argumen untuk string format. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].type |
string |
Jenis argumen. Salah satu dari URL, STRING_LITERAL, INT_LITERAL, CURRENCY, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK, atau SNAPSHOT_RECT.
Nilai yang dapat diterima adalah:
|
|
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].key |
string |
Kunci placeholder untuk argumen ini, sebagai string. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].value |
string |
Nilai argumen, sebagai string yang dilokalkan. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[] |
list |
Persegi panjang layar yang dirujuk, dengan dimensi yang diukur dalam piksel CSS. Ini hanya digunakan untuk argumen SNAPSHOT_RECT. Jika ini tidak ada untuk argumen SNAPSHOT_RECT, berarti argumen tersebut merujuk ke seluruh snapshot. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[] |
list |
Persegi panjang layar sekunder yang dirujuk, dengan dimensi yang diukur dalam piksel CSS. Ini hanya digunakan untuk argumen SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].height |
integer |
||
version |
object |
Versi PageSpeed yang digunakan untuk menampilkan hasil ini. | |
version.major |
integer |
Nomor versi utama PageSpeed yang digunakan untuk menampilkan hasil ini. | |
version.minor |
integer |
Nomor versi minor PageSpeed yang digunakan untuk menghasilkan hasil ini. | |
invalidRules[] |
list |
Daftar aturan yang telah ditentukan dalam permintaan, tetapi server tidak tahu cara membuat instance. | |
screenshot |
nested object |
Screenshot halaman yang dianalisis dengan enkode base64. | |
screenshot.key |
string |
Kunci string unik, jika ada, yang mengidentifikasi gambar ini. | |
screenshot.mime_type |
string |
Jenis MIME data gambar (misalnya "image/jpeg"). | |
screenshot.data |
bytes |
Data gambar dienkode base64. | |
screenshot.width |
integer |
Lebar screenshot dalam piksel. | |
screenshot.height |
integer |
Tinggi screenshot dalam piksel. | |
screenshot.page_rect |
object |
||
screenshot.page_rect.left |
integer |
||
screenshot.page_rect.top |
integer |
||
screenshot.page_rect.width |
integer |
||
screenshot.page_rect.height |
integer |
||
snapshots[] |
list |
Screenshot halaman tambahan yang dienkode base64, dalam berbagai status render parsial. | |
snapshots[].key |
string |
Kunci string unik, jika ada, yang mengidentifikasi gambar ini. | |
snapshots[].mime_type |
string |
Jenis MIME data gambar (misalnya "image/jpeg"). | |
snapshots[].data |
bytes |
Data gambar dienkode base64. | |
snapshots[].width |
integer |
Lebar screenshot dalam piksel. | |
snapshots[].height |
integer |
Tinggi screenshot dalam piksel. | |
snapshots[].page_rect |
object |
||
snapshots[].page_rect.left |
integer |
||
snapshots[].page_rect.top |
integer |
||
snapshots[].page_rect.width |
integer |
||
snapshots[].page_rect.height |
integer |
||
loadingExperience.metrics.(key).category |
string |
Nilai yang dapat diterima adalah:
|
|
loadingExperience.overall_category |
string |
Nilai yang dapat diterima adalah:
|
|
loadingExperience.initial_url |
string |
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat respons.