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 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

enum (Category)

Çalıştırılacak bir Lighthouse kategorisi; herhangi bir kategori 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, 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 (PagespeedApiLoadingExperienceV5)
  },
  "originLoadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "analysisUTCTimestamp": string,
  "lighthouseResult": {
    object (LighthouseResultV5)
  },
  "version": {
    object (PagespeedVersion)
  }
}
Alanlar
kind

string

Bir tür sonuç.
captchaResult

string

Captcha doğrulama sonucu
id

string

Doküman için, sayfa yönlendirmelerinin (varsa) ardından gelen standart ve nihai URL'si.
loadingExperience

object (PagespeedApiLoadingExperienceV5)

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

object (PagespeedApiLoadingExperienceV5)

Kaynağın toplu sayfa yükleme deneyimiyle 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 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 (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))

<metrics, data> haritası.

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

string

Kimliğin insan tarafından okunabilir hız "kategorisi".
initial_url

string

İstenen URL; çözümlenen "kimlik"ten farklı olabilir.
origin_fallback

boolean

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 (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 zaman.
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 çiftlerin 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 çiftlerin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stackPacks[]

object (StackPack)

Stack Pack tavsiye 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 soruna işaret eden ü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'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

string

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

string

Bir denetimin sayfa yüklemeyle ilgili tahmini tasarruf fırsatı başlığı.
opportunitySavingsColumnLabel

string

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

string

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

string

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

string

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

string

Genişletilebilir köşeli çift ayraç simgesindeki ipucu metni.
passedAuditsGroupTitle

string

Başarılı denetimlerin listesinin üstünde 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 denetimler listesinin üzerinde gösterilen başlık.
toplevelWarningsMessage

string

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

string

Puan göstergelerinin ö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 açıklayan 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 çiftlerin 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)
  },
  },
  "performance": {
    object (LighthouseCategoryV5)
  }
}
Alanlar
accessibility

object (LighthouseCategoryV5)

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

object (LighthouseCategoryV5)

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

object (LighthouseCategoryV5)

SEO ile ilgili tüm denetimleri içeren Arama Motoru Optimizasyonu (SEO) 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 anlayabileceği ad.
description

string

Kategori ve önemi hakkında daha ayrıntılı bir açıklama.
manualDescription

string

Kategorideki manuel denetimlerle ilgili açıklama.
auditRefs[]

object (AuditRefs)

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

value (Value format)

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

string

Denetim referans kimliği.
weight

number

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

string

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

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 yapması gereken denetim kategorilerinin listesi.
emulatedFormFactor
(deprecated)

string

Emülasyonun kullanması gereken form faktörü. Bu alan kullanımdan kaldırıldığı için 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, 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

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ı.