Belirtilen URL'deki sayfada Sayfa Hızı analizini çalıştırır ve Sayfa Hızı puanlarını, sayfayı daha hızlı hale getirmeye yönelik önerilerin listesini ve diğer bilgileri döndürür.
HTTP isteği
GET https://pagespeedonline.googleapis.com/pagespeedonline/v5/runPagespeed
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
category |
Çalıştırılacak bir Lighthouse kategorisi; herhangi bir kategori belirtilmemişse yalnızca Performans kategorisi çalıştırılır |
locale |
Biçimlendirilmiş sonuçları yerelleştirmek için kullanılan yerel ayar |
strategy |
Kullanılacak analiz stratejisi (masaüstü veya mobil) ve masaüstü varsayılandır |
url |
Zorunlu. Getirilecek ve analiz edilecek URL |
utm_campaign |
Analiz için kampanya adı. |
utm_source |
Analiz için kampanya kaynağı. |
captchaToken |
Captcha jetonu, bir captcha doldurulurken geçildi. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
Pagespeed API yanıt nesnesi.
JSON gösterimi | |
---|---|
{ "kind": string, "captchaResult": string, "id": string, "loadingExperience": { object ( |
Alanlar | |
---|---|
kind |
Bir tür sonuç. |
captchaResult |
Captcha doğrulama sonucu |
id |
Doküman için, sayfa yönlendirmelerinin (varsa) ardından gelen standart ve nihai URL'si. |
loadingExperience |
Son kullanıcıların sayfa yükleme deneyimine ilişkin metrikler. |
originLoadingExperience |
Kaynağın toplu sayfa yükleme deneyimiyle ilgili metrikler |
analysisUTCTimestamp |
Bu analizin UTC zaman damgası. |
lighthouseResult |
Nesne olarak denetim URL'si için Lighthouse yanıtı. |
version |
Bu sonuçları oluşturmak için kullanılan PageSpeed sürümü. |
Yetkilendirme Kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
openid
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
Kategori
Analiz edilmesi gereken numaralandırılmış kategoriler.
Sıralamalar | |
---|---|
CATEGORY_UNSPECIFIED |
Varsayılan TANIMSIZ kategori. |
ACCESSIBILITY |
Erişilebilirlik (a11y), bir web sitesinin tüm kullanıcılar tarafından erişilebilir olma kapasitesini belirten kategori. |
BEST_PRACTICES |
En İyi Uygulamalar, bir web sitesinin web'deki en iyi uygulamalara uygunluğuyla ilgili kategori. |
PERFORMANCE |
Performans; bir web sitesinin performansıyla ilgili kategoridir. |
SEO |
Arama Motoru Optimizasyonu (SEO), bir web sitesinin arama motorları tarafından dizine eklenebilmesiyle ilgili kategoridir. |
Strateji
Analizde kullanılacak cihaz çalıştırma stratejisi.
Sıralamalar | |
---|---|
STRATEGY_UNSPECIFIED |
TANIMLANMADI. |
DESKTOP |
Masaüstü tarayıcılar için URL'yi alın ve analiz edin. |
MOBILE |
Mobil cihazlara ilişkin URL'yi alın ve analiz edin. |
PagespeedApiLoadingExperienceV5
CrUX veri dökümlerini içeren CrUX yükleme deneyimi nesnesi.
JSON gösterimi | |
---|---|
{
"id": string,
"metrics": {
string: {
object ( |
Alanlar | |
---|---|
id |
Metriklerin bulunduğu URL, kalıp veya kaynak. |
metrics |
<metrics, data> haritası.
|
overall_category |
Kimliğin insan tarafından okunabilir hız "kategorisi". |
initial_url |
İstenen URL; çözümlenen "kimlik"ten farklı olabilir. |
origin_fallback |
Sonuç, bir sayfadan alınan kaynak yedeğiyse doğru, aksi takdirde yanlış değerini alır. |
LighthouseResultV5
Lighthouse sonuç nesnesi.
JSON gösterimi | |
---|---|
{ "fetchTime": string, "requestedUrl": string, "finalUrl": string, "lighthouseVersion": string, "i18n": { object ( |
Alanlar | |
---|---|
fetchTime |
Bu çalıştırmanın getirildiği zaman. |
requestedUrl |
İstenen orijinal URL. |
finalUrl |
Denetlenen nihai çözümlenmiş URL. |
lighthouseVersion |
Bu LHR'yi oluşturmak için kullanılan deniz feneri sürümü. |
i18n |
LHR'yi oluşturmak için gereken uluslararasılaştırma dizeleri. |
userAgent |
Bu LHR'yi çalıştırmak için kullanılan kullanıcı aracısı. |
audits |
LHR'deki denetimlerin haritası.
|
categoryGroups |
LHR'deki kategori gruplarının haritası.
|
stackPacks[] |
Stack Pack tavsiye dizeleri. |
environment |
Bu LHR yapılırken kullanılan ortam ayarları. |
runWarnings |
LHR'de çalıştırılan tüm uyarıların listesi. Her zaman çıkış değeri en az |
runtimeError |
Varsa, bu Lighthouse sonucunun silinmesi gerekebilecek kadar ciddi bir soruna işaret eden üst düzey hata mesajı. |
categories |
LHR'deki kategorilerin haritası. |
timing |
Bu LHR için zamanlama bilgileri. |
configSettings |
Bu LHR için yapılandırma ayarları. |
I18n
LHR - Sürüm 1 için i18n verilerini içeren mesaj.
JSON gösterimi | |
---|---|
{
"rendererFormattedStrings": {
object ( |
Alanlar | |
---|---|
rendererFormattedStrings |
configSettings'te yerel ayara göre biçimlendirilen uluslararası dizeler. |
RendererFormattedStrings
Oluşturucuda kullanılan biçimlendirilmiş dizeleri içeren mesaj.
JSON gösterimi | |
---|---|
{ "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 } |
Alanlar | |
---|---|
varianceDisclaimer |
Performans metriği değerinin altında gösterilen sorumluluk reddi beyanı. |
opportunityResourceColumnLabel |
Bir denetimin sayfa yüklemeyle ilgili tahmini tasarruf fırsatı başlığı. |
opportunitySavingsColumnLabel |
Fırsat denetimlerinden elde edilen tahmini sayfa yükleme tasarrufları başlığı. |
errorMissingAuditInfo |
Hatalı denetimin yanında gösterilen hata dizesi. |
errorLabel |
Hatalı bir denetim veya metriğin yanında gösterilen etiket. |
warningHeader |
Madde işaretli bir uyarı listesinin üzerinde gösterilen etiket. |
auditGroupExpandTooltip |
Genişletilebilir köşeli çift ayraç simgesindeki ipucu metni. |
passedAuditsGroupTitle |
Başarılı denetimlerin listesinin üstünde gösterilen başlık. |
notApplicableAuditsGroupTitle |
Bir sayfa için geçerli olmayan denetimler listesinin üstünde gösterilen başlık. |
manualAuditsGroupTitle |
Çalıştırma sırasında bilgisayarlanmayan denetimler listesinin üzerinde gösterilen başlık. |
toplevelWarningsMessage |
Raporun tamamını geçersiz kılmış olabilecek önemli uyarılardan önce gösterilen etiket. |
scorescaleLabel |
Puan göstergelerinin ölçeğini açıklayan etiket (0-49, 50-89, 90-100). |
crcLongestDurationLabel |
Kritik istek zincirlerinin özetinde gösterilen değerlerin etiketi. |
crcInitialNavigation |
Kritik istek zincirindeki ilk isteğin etiketi. |
lsPerformanceCategoryDescription |
Performansın altında gösterilen ve ağın değişiklik gösterebileceğini açıklayan sorumluluk reddi beyanı. |
labDataTitle |
Laboratuvar verileri performans kategorisinin başlığı. |
StackPack
Yığın Paketi bilgilerini içeren ileti.
JSON gösterimi | |
---|---|
{ "id": string, "title": string, "iconDataURL": string, "descriptions": { string: string, ... } } |
Alanlar | |
---|---|
id |
Yığın paketi kimliği. |
title |
Yığın paketi başlığı. |
iconDataURL |
Yığın paketi simgesi veri URI'si. |
descriptions |
Yığın paketi tavsiye dizeleri.
|
Ortam
Lighthouse çalıştırması için ortam yapılandırmasını içeren mesaj.
JSON gösterimi | |
---|---|
{ "networkUserAgent": string, "hostUserAgent": string, "benchmarkIndex": number } |
Alanlar | |
---|---|
networkUserAgent |
Ağ üzerinden gönderilen kullanıcı aracısı dizesi. |
hostUserAgent |
Kullanılan Chrome sürümünün kullanıcı aracısı dizesi. |
benchmarkIndex |
Yaklaşık cihaz sınıfını gösteren karşılaştırma dizin numarası. |
RuntimeError
Çalışma zamanı hata yapılandırması içeren mesaj.
JSON gösterimi | |
---|---|
{ "code": string, "message": string } |
Alanlar | |
---|---|
code |
Numaralı Lighthouse Hata kodu. |
message |
Hata kodunu açıklayan, kullanıcıların okuyabileceği bir mesaj. |
Kategoriler
Bir Lighthouse çalıştırmasındaki kategoriler.
JSON gösterimi | |
---|---|
{ "accessibility": { object ( |
Alanlar | |
---|---|
accessibility |
Erişilebilirlikle ilgili tüm denetimleri içeren erişilebilirlik kategorisi. |
best-practices |
En iyi uygulamalar kategorisi ile ilgili en iyi uygulamalarla ilgili tüm denetimleri içeren kategori. |
seo |
SEO ile ilgili tüm denetimleri içeren Arama Motoru Optimizasyonu (SEO) kategorisi. |
performance |
Performansla ilgili tüm denetimleri içeren performans kategorisi. |
LighthouseCategoryV5
Bir Lighthouse kategorisi.
JSON gösterimi | |
---|---|
{
"id": string,
"title": string,
"description": string,
"manualDescription": string,
"auditRefs": [
{
object ( |
Alanlar | |
---|---|
id |
Kategorinin dize tanımlayıcısı. |
title |
Kategorinin kullanıcıların rahatça anlayabileceği ad. |
description |
Kategori ve önemi hakkında daha ayrıntılı bir açıklama. |
manualDescription |
Kategorideki manuel denetimlerle ilgili açıklama. |
auditRefs[] |
Bu kategorinin tüm denetim üyelerine yönelik bir referans dizisi. |
score |
Kategorinin genel puanı, tüm denetimlerinin ağırlıklı ortalaması. (Kategorinin puanı boş olabilir.) |
AuditRefs
Belirli bir kategorideki denetimleri gruplandırmak ve ağırlıklandırmak için kullanılan, kimliğe göre denetlemeye hafif referans.
JSON gösterimi | |
---|---|
{ "id": string, "weight": number, "group": string } |
Alanlar | |
---|---|
id |
Denetim referans kimliği. |
weight |
Bu denetimin puanının genel kategori puanı üzerindeki ağırlığı. |
group |
Denetlemenin ait olduğu kategori grubu (isteğe bağlı). |
Zamanlama
Lighthouse çalıştırması için performans zamanlaması verilerini içeren mesaj.
JSON gösterimi | |
---|---|
{ "total": number } |
Alanlar | |
---|---|
total |
Lighthouse'un toplam çalışma süresi. |
ConfigSettings
Lighthouse çalıştırmasının yapılandırma ayarlarını içeren ileti.
JSON gösterimi | |
---|---|
{ "onlyCategories": value, "emulatedFormFactor": string, "locale": string, "channel": string, "formFactor": string } |
Alanlar | |
---|---|
onlyCategories |
Çalıştırmanın yapması gereken denetim kategorilerinin listesi. |
emulatedFormFactor |
Emülasyonun kullanması gereken form faktörü. Bu alan kullanımdan kaldırıldığı için bunun yerine formFactor kullanılmalıdır. |
locale |
Yerel ayar. |
channel |
Lighthouse'un nasıl çalıştırıldığı (ör. Chrome uzantısından veya npm modülünden). |
formFactor |
Lighthouse, performans metriklerini puanlama ve masaüstünde yalnızca mobil cihazlara yönelik testleri atlama açısından bu çalıştırmayı nasıl yorumlamalıdır? |
PagespeedVersion
PageSpeed Sürümü nesnesi.
JSON gösterimi | |
---|---|
{ "major": string, "minor": string } |
Alanlar | |
---|---|
major |
Bu sonuçları oluşturmak için kullanılan PageSpeed'in ana sürüm numarası. |
minor |
Bu sonuçları oluşturmak için kullanılan PageSpeed'in alt sürüm numarası. |