Method: pagespeedapi.runpagespeed

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

enum (Category)

Çalıştırılacak bir Lighthouse kategorisi; herhangi bir değer belirtilmezse 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ılan değerdir

url

string

Zorunlu. Getirilecek ve analiz edilecek URL

utm_campaign

string

Analytics için kampanya adı.

utm_source

string

Analiz için kampanya kaynağı.

captchaToken

string

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

string

Bu tür bir sonuç.

captchaResult

string

Captcha doğrulama sonucu

id

string

Sayfa yönlendirmelerinden (varsa) sonra dokümanın standartlaştırılmış ve nihai URL'si.

loadingExperience

object (PagespeedApiLoadingExperienceV5)

Son kullanıcıların metrikleri pek çok değişiklik yapabilirsiniz.

originLoadingExperience

object (PagespeedApiLoadingExperienceV5)

Kaynağın toplu sayfa yükleme deneyimine ilişkin metrikler

analysisUTCTimestamp

string

Bu analizin UTC zaman damgası.

lighthouseResult

object (LighthouseResultV5)

Nesne olarak denetleme 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 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 (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 çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

overall_category

string

İnsan tarafından okunabilir hız "kategorisi" vardır.

initial_url

string

İstenen URL. Bu URL çözümlenen "id" değerinden farklı olabilir.

origin_fallback

boolean

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 (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 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 hazırlanırken kullanılan ortam ayarları.

runWarnings

array (ListValue format)

LHR'deki tüm çalıştırma uyarılarının listesi. Her zaman en az [] çıktısı verir.

runtimeError

object (RuntimeError)

Varsa, bu Lighthouse sonucunun silinmesini gerektirecek kadar ciddi bir sorun olduğunu gösteren üst düzey bir hata mesajı.

categories

object (Categories)

LHR'deki kategoriler haritası.

timing

object (Timing)

Bu LHR için zamanlama bilgileri.

configSettings

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

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

string

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

opportunityResourceColumnLabel

string

Bir denetim için tahmini sayfa yükleme tasarrufu fırsatının başlığı.

opportunitySavingsColumnLabel

string

Fırsat denetimlerinin sayfa yüklemesiyle ilgili tahmini tasarruf başlığı.

errorMissingAuditInfo

string

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

errorLabel

string

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

warningHeader

string

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

auditGroupExpandTooltip

string

Genişletilebilir zikzak simgesi üzerindeki ipucu metni.

passedAuditsGroupTitle

string

Geçmekte olan denetimler listesinin üzerinde gösterilen başlık.

notApplicableAuditsGroupTitle

string

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

manualAuditsGroupTitle

string

Çalıştırma sırasında bilgisayarlandırılmamış denetimler listesinin üstünde gösterilen başlık.

toplevelWarningsMessage

string

Bir raporun tamamını geçersiz kılmış olabilecek önemli uyarıların önünde gösterilen etiket.

scorescaleLabel

string

Puan göstergelerini 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 öneri 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

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

string

Numaralanmış Lighthouse Hata kodu.

message

string

Hata kodunu açıklayan, okunabilir bir mesaj.

Kategoriler

Lighthouse çalışması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 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.

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 insanlara uygun 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 kategorideki tüm denetim üyelerine yönelik bir referans dizisi.

score

value (Value format)

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

string

Denetleme referans kimliği.

weight

number

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

group

string

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

number

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

value (Value format)

Çalıştırmanın gerçekleştirmesi 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

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

string

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

minor

string

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