Belirtilen URL'deki sayfada Sayfa Hızı analizini çalıştırır ve Sayfa Hızı puanlarını, söz konusu 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 değer belirtilmezse 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ılan değerdir |
url |
Zorunlu. Getirilecek ve analiz edilecek URL |
utm_campaign |
Analytics için kampanya adı. |
utm_source |
Analiz için kampanya kaynağı. |
captchaToken |
Bir captcha'yı doldururken gönderilen captcha jetonu. |
İ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 |
Bu tür bir sonuç. |
captchaResult |
Captcha doğrulama sonucu |
id |
Sayfa yönlendirmelerinden (varsa) sonra dokümanın standartlaştırılmış ve nihai URL'si. |
loadingExperience |
Son kullanıcıların metrikleri pek çok değişiklik yapabilirsiniz. |
originLoadingExperience |
Kaynağın toplu sayfa yükleme deneyimine ilişkin metrikler |
analysisUTCTimestamp |
Bu analizin UTC zaman damgası. |
lighthouseResult |
Nesne olarak denetleme 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
Kategori
Analiz edilmesi gereken, numaralandırılmış kategoriler.
Sıralamalar | |
---|---|
CATEGORY_UNSPECIFIED |
Varsayılan UNDEFINED kategorisi. |
ACCESSIBILITY |
Erişilebilirlik (a11y), bir web sitesinin tüm kullanıcılar için erişilebilir olma kapasitesiyle ilgili kategori. |
BEST_PRACTICES |
En İyi Uygulamalar, bir web sitesinin web'deki en iyi uygulamaya uygunluğu kategorisi. |
PERFORMANCE |
Performans, web sitesinin performansıyla ilgili kategori. |
SEO |
Arama Motoru Optimizasyonu (SEO), bir web sitesinin arama motorları tarafından dizine eklenebilmesi ile ilgili kategori. |
Strateji
Analizde kullanılacak cihaz çalıştırma stratejisi.
Sıralamalar | |
---|---|
STRATEGY_UNSPECIFIED |
TANIMSIZ. |
DESKTOP |
Masaüstü tarayıcılarına yönelik URL'yi getirin ve analiz edin. |
MOBILE |
Mobil cihazlara yönelik URL'yi getirin 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 |
İnsan tarafından okunabilir hız "kategorisi" vardır. |
initial_url |
İstenen URL. Bu URL çözümlenen "id" değerinden farklı olabilir. |
origin_fallback |
Sonuç bir sayfadan kaynak yedeğiyse doğru, aksi takdirde false 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 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[] |
Yığın Paketi öneri dizeleri. |
environment |
Bu LHR hazırlanırken kullanılan ortam ayarları. |
runWarnings |
LHR'deki tüm çalıştırma uyarılarının listesi. Her zaman en az |
runtimeError |
Varsa, bu Lighthouse sonucunun silinmesini gerektirecek kadar ciddi bir sorun olduğunu gösteren üst düzey bir hata mesajı. |
categories |
LHR'deki kategoriler haritası. |
timing |
Bu LHR için zamanlama bilgileri. |
configSettings |
Bu LHR için yapılandırma ayarları. |
i18n
LHR için i18n verilerini içeren mesaj - Sürüm 1.
JSON gösterimi | |
---|---|
{
"rendererFormattedStrings": {
object ( |
Alanlar | |
---|---|
rendererFormattedStrings |
configSettings'te yerel ayara göre biçimlendirilen uluslararasılaştırılmış 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 denetim için tahmini sayfa yükleme tasarrufu fırsatının başlığı. |
opportunitySavingsColumnLabel |
Fırsat denetimlerinin sayfa yüklemesiyle ilgili tahmini tasarruf başlığı. |
errorMissingAuditInfo |
Hatalı bir denetimin yanında gösterilen hata dizesi. |
errorLabel |
Hatalı olan bir denetim veya metriğin yanında gösterilen etiket. |
warningHeader |
Madde işaretli uyarı listesinin üzerinde gösterilen etiket. |
auditGroupExpandTooltip |
Genişletilebilir zikzak simgesi üzerindeki ipucu metni. |
passedAuditsGroupTitle |
Geçmekte olan denetimler listesinin üzerinde gösterilen başlık. |
notApplicableAuditsGroupTitle |
Bir sayfa için geçerli olmayan denetimlerin listesinin üstünde gösterilen başlık. |
manualAuditsGroupTitle |
Çalıştırma sırasında bilgisayarlandırılmamış denetimler listesinin üstünde gösterilen başlık. |
toplevelWarningsMessage |
Bir raporun tamamını geçersiz kılmış olabilecek önemli uyarıların önünde gösterilen etiket. |
scorescaleLabel |
Puan göstergelerini 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 öneri 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 |
Cihaz sınıfını yaklaşık olarak gösteren karşılaştırma dizin numarası. |
RuntimeError
Çalışma zamanı hatası yapılandırması içeren mesaj.
JSON gösterimi | |
---|---|
{ "code": string, "message": string } |
Alanlar | |
---|---|
code |
Numaralanmış Lighthouse Hata kodu. |
message |
Hata kodunu açıklayan, okunabilir bir mesaj. |
Kategoriler
Lighthouse çalışmasındaki kategoriler.
JSON gösterimi | |
---|---|
{ "accessibility": { object ( |
Alanlar | |
---|---|
accessibility |
Erişilebilirlikle ilgili tüm denetimleri içeren erişilebilirlik kategorisi. |
best-practices |
En iyi uygulamalarla ilgili tüm denetimleri içeren en iyi uygulamalar kategorisi. |
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 insanlara uygun adı. |
description |
Kategori ve önemi hakkında daha ayrıntılı bir açıklama. |
manualDescription |
Kategorideki manuel denetimlerle ilgili açıklama. |
auditRefs[] |
Bu kategorideki tüm denetim üyelerine yönelik bir referans dizisi. |
score |
Kategorinin genel puanı, yani 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 denetime hafif referans.
JSON gösterimi | |
---|---|
{ "id": string, "weight": number, "group": string } |
Alanlar | |
---|---|
id |
Denetleme referans kimliği. |
weight |
Bu denetim puanının genel kategori puanı üzerindeki ağırlığı. |
group |
Denetimin ait olduğu kategori grubu (isteğe bağlı). |
Zamanlama
Lighthouse çalışması için performans zamanlama verilerini içeren mesaj.
JSON gösterimi | |
---|---|
{ "total": number } |
Alanlar | |
---|---|
total |
Lighthouse'un toplam koşu süresi. |
ConfigSettings
Lighthouse çalıştırması için 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 gerçekleştirmesi 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 |
Masaüstünde performans metriklerini puanlama ve yalnızca mobil cihazlara yönelik testleri atlama konusunda Lighthouse'un bu çalıştırmayı nasıl yorumlaması gerektiği. |
PagespeedVersion
Pagespeed Version nesnesi.
JSON gösterimi | |
---|---|
{ "major": string, "minor": string } |
Alanlar | |
---|---|
major |
Bu sonuçları oluşturmak için kullanılan PageSpeed ana sürüm numarası. |
minor |
Bu sonuçları oluşturmak için kullanılan PageSpeed alt sürüm numarası. |