Method: pagespeedapi.runpagespeed

Belirtilen URL'deki sayfada Sayfa Hızı analizini çalıştırır ve Sayfa Hızı puanlarını, sayfayı daha hızlı hale getirmenizi sağlayacak önerilerin bir 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

enum (Category)

Çalıştırılacak bir Lighthouse kategorisi; belirtilmemişse yalnızca Performans kategorisi çalıştırılır
locale

string

Biçimlendirilmiş sonuçları yerelleştirmek için kullanılan yerel ayar
strategy

enum (Strategy)

Kullanılacak analiz stratejisi (masaüstü veya mobil) ve masaüstü varsayılandır
url

string

Zorunlu. Getirilecek ve analiz edilecek URL
utm_campaign

string

Analiz için kampanya adı.
utm_source

string

Analiz için kampanya kaynağı.
captchaToken

string

Captcha jetonu, captcha'yı doldururken geçer.

İ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 (PagespeedApiLoadingExperienceV5)
  },
  "originLoadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "analysisUTCTimestamp": string,
  "lighthouseResult": {
    object (LighthouseResultV5)
  },
  "version": {
    object (PagespeedVersion)
  }
}
Alanlar
kind

string

Bir sonuç türü.
captchaResult

string

Captcha doğrulama sonucu
id

string

Dokümanın standart ve nihai URL'si, sayfa yönlendirmelerinden (varsa) sonra.
loadingExperience

object (PagespeedApiLoadingExperienceV5)

Son kullanıcıların sayfa yükleme deneyimine ilişkin metrikler.
originLoadingExperience

object (PagespeedApiLoadingExperienceV5)

Kaynağın toplu sayfa yükleme deneyimi ile ilgili metrikler
analysisUTCTimestamp

string

Bu analizin UTC zaman damgası.
lighthouseResult

object (LighthouseResultV5)

Nesne olarak denetim URL'si için Lighthouse yanıtı.
version

object (PagespeedVersion)

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 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 uygulamalara uygunluğuyla ilgili kategori.
PERFORMANCE Performans; web sitesinin performansıyla ilgili kategori
PWA Progresif Web Uygulaması (PWA) kategorisi. Bir web sitesinin PWA olarak çalıştırılabilmesini sağlar.
SEO Arama Motoru Optimizasyonu (SEO), bir web sitesinin arama motorları tarafından dizine eklenebilmesiyle ilgili kategori.

Strateji

Analizde kullanılacak olan çalıştırma stratejisi.

Sıralamalar
STRATEGY_UNSPECIFIED TANIMLANMADI.
DESKTOP Masaüstü tarayıcıların URL'sini alın ve analiz edin.
MOBILE Mobil cihazlara ilişkin 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 (UserPageLoadMetricV5)
    },
    ...
  },
  "overall_category": string,
  "initial_url": string,
  "origin_fallback": boolean
}
Alanlar
id

string

Metriklerin bulunduğu URL, kalıp veya kaynak.
metrics

map (key: string, value: object (UserPageLoadMetricV5))

<metric, data> haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
overall_category

string

Kimliğin okunabilir hız "kategorisi".
initial_url

string

İstenen URL; çözümlenen "id"den farklı olabilir.
origin_fallback

boolean

Sonuç, bir sayfadan alınan yedek kaynaksa doğru değerini, aksi takdirde yanlış değerini alır.

LighthouseResultV5

Lighthouse sonuç nesnesi.

JSON gösterimi 
{
  "fetchTime": string,
  "requestedUrl": string,
  "finalUrl": string,
  "lighthouseVersion": string,
  "i18n": {
    object (I18n)
  },
  "userAgent": string,
  "audits": {
    string: {
      object (LighthouseAuditResultV5)
    },
    ...
  },
  "categoryGroups": {
    string: {
      object (CategoryGroupV5)
    },
    ...
  },
  "stackPacks": [
    {
      object (StackPack)
    }
  ],
  "environment": {
    object (Environment)
  },
  "runWarnings": array,
  "runtimeError": {
    object (RuntimeError)
  },
  "categories": {
    object (Categories)
  },
  "timing": {
    object (Timing)
  },
  "configSettings": {
    object (ConfigSettings)
  }
}
Alanlar
fetchTime

string

Bu çalıştırmanın getirildiği zamandır.
requestedUrl

string

İstenen orijinal URL.
finalUrl

string

Denetlenen nihai çözümlenmiş URL.
lighthouseVersion

string

Bu LHR'yi oluşturmak için kullanılan deniz feneri sürümü.
i18n

object (I18n)

LHR'yi oluşturmak için gereken uluslararasılaştırma dizeleri.
userAgent

string

Bu LHR'yi çalıştırmak için kullanılan kullanıcı aracısı.
audits

map (key: string, value: object (LighthouseAuditResultV5))

LHR'deki denetimlerin haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
categoryGroups

map (key: string, value: object (CategoryGroupV5))

LHR'deki kategori gruplarının haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stackPacks[]

object (StackPack)

Yığın Paketi öneri dizeleri.
environment

object (Environment)

Bu LHR yapılırken kullanılan ortam ayarları.
runWarnings

array (ListValue format)

LHR'de çalıştırılan tüm uyarıların listesi. Her zaman çıkış değeri en az [] olur.
runtimeError

object (RuntimeError)

Varsa, bu Lighthouse sonucunun silinmesi gerekebilecek kadar ciddi bir sorunu gösteren üst düzey hata mesajı.
categories

object (Categories)

LHR'deki kategorilerin haritası.
timing

object (Timing)

Bu LHR için zamanlama bilgileri.
configSettings

object (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 (RendererFormattedStrings)
  }
}
Alanlar
rendererFormattedStrings

object (RendererFormattedStrings)

configSettings'deki 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

string

Performans metriği değerinin altında gösterilen sorumluluk reddi beyanı.
opportunityResourceColumnLabel

string

Bir denetimin tahmini sayfa yükleme tasarrufu fırsatıyla ilgili başlık.
opportunitySavingsColumnLabel

string

Fırsat denetimleriyle elde edilen tahmini sayfa yükleme tasarrufu başlığı.
errorMissingAuditInfo

string

Hatalı bir denetimin yanında gösterilen hata dizesi.
errorLabel

string

Hatalı bir denetimin veya metriğin yanında gösterilen etiket.
warningHeader

string

Madde işaretli bir uyarı listesinin üzerinde gösterilen etiket.
auditGroupExpandTooltip

string

Genişletilebilir v ayracı simgesinin üzerindeki ipucu metni.
passedAuditsGroupTitle

string

Başarılı denetimlerin listesinin üzerinde gösterilen başlık.
notApplicableAuditsGroupTitle

string

Bir sayfa için geçerli olmayan denetimler listesinin üstünde gösterilen başlık.
manualAuditsGroupTitle

string

Çalıştırma sırasında bilgisayarlanmayan denetimlerin listesinin üzerinde gösterilen başlık.
toplevelWarningsMessage

string

Bir raporun tamamını geçersiz kılmış olabilecek önemli uyarılardan önce gösterilen etiket.
scorescaleLabel

string

Puan gösterge ölçeğini açıklayan etiket (0-49, 50-89, 90-100).
crcLongestDurationLabel

string

Kritik istek zincirlerinin özetinde gösterilen değerlerin etiketi.
crcInitialNavigation

string

Kritik istek zincirindeki ilk isteğin etiketi.
lsPerformanceCategoryDescription

string

Performansın altında gösterilen ve ağın değişiklik gösterebileceğini belirten sorumluluk reddi beyanı.
labDataTitle

string

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

string

Yığın paketi kimliği.
title

string

Yığın paketi başlığı.
iconDataURL

string

Yığın paketi simgesi veri URI'si.
descriptions

map (key: string, value: string)

Yığın paketi tavsiye dizeleri.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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

string

Ağ üzerinden gönderilen kullanıcı aracısı dizesi.
hostUserAgent

string

Kullanılan Chrome sürümünün kullanıcı aracısı dizesi.
benchmarkIndex

number

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

string

Numaralı Lighthouse Hata kodu.
message

string

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 (LighthouseCategoryV5)
  },
  "best-practices": {
    object (LighthouseCategoryV5)
  },
  "seo": {
    object (LighthouseCategoryV5)
  },
  "pwa": {
    object (LighthouseCategoryV5)
  },
  "performance": {
    object (LighthouseCategoryV5)
  }
}
Alanlar
accessibility

object (LighthouseCategoryV5)

Erişilebilirlikle ilgili tüm denetimleri içeren erişilebilirlik kategorisi.
best-practices

object (LighthouseCategoryV5)

En iyi uygulamalarla ilgili tüm denetimleri içeren en iyi uygulamalar kategorisi.
seo

object (LighthouseCategoryV5)

SEO ile ilgili tüm denetimleri içeren Arama Motoru Optimizasyonu (SEO) kategorisi.
pwa

object (LighthouseCategoryV5)

PWA ile ilgili tüm denetimleri içeren PWA (Progresif Web Uygulaması) (PWA) kategorisi.
performance

object (LighthouseCategoryV5)

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 (AuditRefs)
    }
  ],
  "score": value
}
Alanlar
id

string

Kategorinin dize tanımlayıcısı.
title

string

Kategorinin kullanıcıların rahatça okuyabildiği ad.
description

string

Kategorinin ve öneminin daha ayrıntılı bir açıklaması.
manualDescription

string

Kategorideki manuel denetimlerin açıklaması.
auditRefs[]

object (AuditRefs)

Bu kategorinin tüm denetim üyelerine yönelik bir referans dizisi.
score

value (Value format)

Kategorinin genel puanı ve 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

string

Denetim referans kimliği
weight

number

Bu denetimin puanının genel kategori puanı üzerindeki ağırlığı.
group

string

Denetimin ait olduğu kategori grubu (isteğe bağlı).

Zamanlama

Lighthouse çalıştırmasının performans zamanlaması verilerini içeren mesaj.

JSON gösterimi 
{
  "total": number
}
Alanlar
total

number

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

value (Value format)

Çalıştırmanın yürütmesi gereken denetleme kategorilerinin listesi.
emulatedFormFactor
(deprecated)

string

Emülasyonun kullanması gereken form faktörü. Bu alan kullanımdan kaldırıldı, bunun yerine formFactor kullanılmalıdır.
locale

string

Yerel ayar.
channel

string

Lighthouse'un nasıl çalıştırıldığı (ör. Chrome uzantısından veya npm modülünden)
formFactor

string

Lighthouse'un, performans metriklerini puanlama ve masaüstünde yalnızca mobil cihazlara yönelik testleri atlama açısından bu çalıştırmayı nasıl yorumlaması gerektiğini öğrenin.

PagespeedVersion

PageSpeed Version nesnesi.

JSON gösterimi 
{
  "major": string,
  "minor": string
}
Alanlar
major

string

Bu sonuçları oluşturmak için kullanılan PageSpeed'in ana sürüm numarası.
minor

string

Bu sonuçları oluşturmak için kullanılan PageSpeed'in alt sürüm numarası.