Führt eine PageSpeed-Analyse auf der Seite unter der angegebenen URL durch und gibt PageSpeed-Werte, eine Liste mit Vorschlägen zur Verbesserung der Geschwindigkeit dieser Seite sowie weitere Informationen zurück.
HTTP-Anfrage
GET https://pagespeedonline.googleapis.com/pagespeedonline/v5/runPagespeed
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
category |
Eine Lighthouse-Kategorie, die ausgeführt werden soll. Wenn keine angegeben sind, wird nur die Leistungskategorie ausgeführt. |
locale |
Die Sprache, die zur Lokalisierung formatierter Ergebnisse verwendet wird |
strategy |
Die zu verwendende Analysestrategie (Computer oder Mobilgerät) und Desktop sind die Standardeinstellung |
url |
Erforderlich. Die URL zum Abrufen und Analysieren |
utm_campaign |
Kampagnenname für Analysen. |
utm_source |
Kampagnenquelle für Analysen. |
captchaToken |
Das beim Ausfüllen eines Captcha übergebene Captcha-Token. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
Das Antwortobjekt der Pagespeed API.
JSON-Darstellung | |
---|---|
{ "kind": string, "captchaResult": string, "id": string, "loadingExperience": { object ( |
Felder | |
---|---|
kind |
Art des Ergebnisses. |
captchaResult |
Ergebnis der Captcha-Bestätigung |
id |
Kanonisierte und finale URL für das Dokument nach Folgen von Seitenweiterleitungen (falls vorhanden). |
loadingExperience |
Messwerte zum Seitenaufbau der Endnutzer. |
originLoadingExperience |
Messwerte für den aggregierten Seitenaufbau des Ursprungs |
analysisUTCTimestamp |
Der UTC-Zeitstempel dieser Analyse. |
lighthouseResult |
Lighthouse-Antwort für die Audit-URL als Objekt. |
version |
Die Version von PageSpeed, mit der diese Ergebnisse generiert wurden. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
openid
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Kategorie
Die Aufzählungskategorien, die analysiert werden sollten.
Enums | |
---|---|
CATEGORY_UNSPECIFIED |
Standardkategorie NICHT DEFINIERT. |
ACCESSIBILITY |
Barrierefreiheit (A11y), Kategorie in Bezug auf die Fähigkeit einer Website, für alle Nutzenden barrierefrei zu sein. |
BEST_PRACTICES |
Best Practices, Kategorie in Bezug auf die Konformität einer Website mit Best Practices für das Web. |
PERFORMANCE |
Leistung, Kategorie, die sich auf die Leistung einer Website bezieht. |
SEO |
Suchmaschinenoptimierung (SEO) ist eine Kategorie, die sich auf die Fähigkeit einer Website bezieht, von Suchmaschinen indexiert zu werden. |
Strategie
Die Strategie zur Ausführung des Geräts, die in der Analyse verwendet werden soll.
Enums | |
---|---|
STRATEGY_UNSPECIFIED |
NICHT DEFINIERT. |
DESKTOP |
URL für Desktop-Browser abrufen und analysieren |
MOBILE |
URL für Mobilgeräte abrufen und analysieren |
PagespeedApiLoadingExperienceV5
Das CrUX-Ladeerlebnisobjekt, das CrUX-Datenaufschlüsselungen enthält.
JSON-Darstellung | |
---|---|
{
"id": string,
"metrics": {
string: {
object ( |
Felder | |
---|---|
id |
Die URL, das Muster oder der Ursprung, von dem bzw. dem die Messwerte stammen. |
metrics |
Die Map von <metrics, data>. Ein Objekt, das eine Liste von |
overall_category |
Die für Menschen lesbare Geschwindigkeits-„Kategorie“ der ID. |
initial_url |
Die angeforderte URL, die sich von der aufgelösten ID unterscheiden kann. |
origin_fallback |
„True“, wenn das Ergebnis ein Ursprungs-Fallback von einer Seite ist, andernfalls „false“. |
LighthouseResultV5
Das Lighthouse-Ergebnisobjekt.
JSON-Darstellung | |
---|---|
{ "fetchTime": string, "requestedUrl": string, "finalUrl": string, "lighthouseVersion": string, "i18n": { object ( |
Felder | |
---|---|
fetchTime |
Der Zeitpunkt, zu dem diese Ausführung abgerufen wurde. |
requestedUrl |
Die ursprünglich angeforderte URL. |
finalUrl |
Die endgültige geklärte URL, die geprüft wurde. |
lighthouseVersion |
Die Lighthouse-Version, mit der dieses LHR generiert wurde. |
i18n |
Die Internationalisierungsstrings, die zum Rendern des LHR erforderlich sind. |
userAgent |
Der User-Agent, der zum Ausführen dieses LHR verwendet wurde. |
audits |
Karte der Audits im LHR. Ein Objekt, das eine Liste von |
categoryGroups |
Karte von Kategoriegruppen im LHR. Ein Objekt, das eine Liste von |
stackPacks[] |
Die Stack Pack-Ratstrings. |
environment |
Umgebungseinstellungen, die beim Erstellen dieses LHR verwendet wurden. |
runWarnings |
Liste aller Ausführungswarnungen im LHR. Wird immer in mindestens |
runtimeError |
Eine Fehlermeldung auf oberster Ebene, die gegebenenfalls auf ein schwerwiegendes Problem hinweist, dass dieses Lighthouse-Ergebnis möglicherweise verworfen werden muss. |
categories |
Karte der Kategorien im LHR. |
timing |
Zeitangaben für diese LHR. |
configSettings |
Die Konfigurationseinstellungen für dieses LHR. |
L18n
Nachricht mit den i18n-Daten für das LHR - Version 1.
JSON-Darstellung | |
---|---|
{
"rendererFormattedStrings": {
object ( |
Felder | |
---|---|
rendererFormattedStrings |
Internationalisierte Strings, die gemäß der Sprache in „configSettings“ formatiert sind. |
RendererFormattedStrings
Nachricht mit den formatierten Strings, die im Renderer verwendet werden.
JSON-Darstellung | |
---|---|
{ "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 } |
Felder | |
---|---|
varianceDisclaimer |
Der Haftungsausschluss, der unter einem Leistungsmesswert angezeigt wird. |
opportunityResourceColumnLabel |
Die Überschrift für die geschätzten Einsparungen beim Seitenaufbau bei einer Prüfung. |
opportunitySavingsColumnLabel |
Die Überschrift für die geschätzten Einsparungen beim Seitenaufbau durch Empfehlungensprüfungen. |
errorMissingAuditInfo |
Der Fehlerstring, der neben einem fehlerhaften Audit angezeigt wird. |
errorLabel |
Das Label neben einer Prüfung oder einem Messwert, bei dem ein Fehler aufgetreten ist. |
warningHeader |
Das Label über einer Aufzählungsliste mit Warnungen. |
auditGroupExpandTooltip |
Der Text der Kurzinfo auf einem maximierbaren Chevron-Symbol. |
passedAuditsGroupTitle |
Die Überschrift, die über einer Liste der bestandenen Prüfungen angezeigt wird. |
notApplicableAuditsGroupTitle |
Die Überschrift oben zeigt eine Liste von Prüfungen, die nicht für eine Seite gelten. |
manualAuditsGroupTitle |
Die Überschrift oben zeigt eine Liste von Audits, die bei der Ausführung nicht computergeneriert wurden. |
toplevelWarningsMessage |
Das Label, das vor wichtigen Warnungen angezeigt wurde, durch die möglicherweise ein gesamter Bericht für ungültig erklärt wurde. |
scorescaleLabel |
Das Label zur Erklärung der Bewertungsskala (0–49, 50–89, 90–100). |
crcLongestDurationLabel |
Das Label für Werte, die in der Zusammenfassung der Ketten kritischer Anfragen angezeigt werden. |
crcInitialNavigation |
Das Label für die erste Anfrage in einer Kette kritischer Anfragen. |
lsPerformanceCategoryDescription |
Der unter „Leistung“ angezeigte Haftungsausschluss, aus dem hervorgeht, dass das Netzwerk variieren kann. |
labDataTitle |
Der Titel der Kategorie der Lab-Datenleistung. |
StackPack
Nachricht mit Stack Pack-Informationen.
JSON-Darstellung | |
---|---|
{ "id": string, "title": string, "iconDataURL": string, "descriptions": { string: string, ... } } |
Felder | |
---|---|
id |
Die Stack-Pack-ID. |
title |
Der Titel des Stapelpakets. |
iconDataURL |
Der Daten-URI für das Stack-Pack-Symbol. |
descriptions |
Die Empfehlungsstrings für das Stack Pack. Ein Objekt, das eine Liste von |
Umgebung
Nachricht mit Umgebungskonfiguration für eine Lighthouse-Ausführung.
JSON-Darstellung | |
---|---|
{ "networkUserAgent": string, "hostUserAgent": string, "benchmarkIndex": number } |
Felder | |
---|---|
networkUserAgent |
Der User-Agent-String, der über das Netzwerk gesendet wurde. |
hostUserAgent |
Der User-Agent-String der verwendeten Chrome-Version. |
benchmarkIndex |
Die Benchmark-Indexnummer, die die ungefähre Geräteklasse angibt. |
RuntimeError
Nachricht mit einer Laufzeitfehlerkonfiguration.
JSON-Darstellung | |
---|---|
{ "code": string, "message": string } |
Felder | |
---|---|
code |
Der aufgezählte Lighthouse-Fehlercode. |
message |
Eine menschenlesbare Meldung, in der der Fehlercode erläutert wird. |
Kategorien
Die Kategorien in einem Lighthouse-Durchlauf.
JSON-Darstellung | |
---|---|
{ "accessibility": { object ( |
Felder | |
---|---|
accessibility |
Die Kategorie „Barrierefreiheit“, die alle Prüfungen zur Barrierefreiheit enthält. |
best-practices |
Die Kategorie „Best Practices“, die alle Audits in Bezug auf Best Practices enthält |
seo |
Die Kategorie Suchmaschinenoptimierung (SEO) mit allen SEO-Audits. |
performance |
Die Leistungskategorie, die alle leistungsbezogenen Prüfungen enthält. |
LighthouseCategoryV5
Eine Lighthouse-Kategorie.
JSON-Darstellung | |
---|---|
{
"id": string,
"title": string,
"description": string,
"manualDescription": string,
"auditRefs": [
{
object ( |
Felder | |
---|---|
id |
Die String-ID der Kategorie. |
title |
Der leicht zu merkende Name der Kategorie. |
description |
Eine detailliertere Beschreibung der Kategorie und ihrer Bedeutung. |
manualDescription |
Eine Beschreibung der manuellen Audits in der Kategorie. |
auditRefs[] |
Ein Array von Referenzen zu allen Audit-Mitgliedern dieser Kategorie. |
score |
Die Gesamtpunktzahl der Kategorie, der gewichtete Durchschnitt aller ihrer Prüfungen. (Die Punktzahl der Kategorie kann null sein.) |
AuditRefs
Ein einfacher Verweis auf einen Audit nach ID, der verwendet wird, um Audits in einer bestimmten Kategorie zu gruppieren und zu gewichten.
JSON-Darstellung | |
---|---|
{ "id": string, "weight": number, "group": string } |
Felder | |
---|---|
id |
Die Audit-Ref.-ID. |
weight |
Die Gewichtung, die die Punktzahl dieses Audits auf die Gesamtbewertung der Kategorie stützt. |
group |
Die Kategoriegruppe, zu der das Audit gehört (optional). |
Dauer
Nachricht mit den Daten zum Leistungszeitraum der Lighthouse-Ausführung.
JSON-Darstellung | |
---|---|
{ "total": number } |
Felder | |
---|---|
total |
Die gesamte Ausführungsdauer von Lighthouse. |
ConfigSettings
Nachricht mit den Konfigurationseinstellungen für die Lighthouse-Ausführung.
JSON-Darstellung | |
---|---|
{ "onlyCategories": value, "emulatedFormFactor": string, "locale": string, "channel": string, "formFactor": string } |
Felder | |
---|---|
onlyCategories |
Liste der Kategorien von Audits, die bei der Ausführung durchgeführt werden sollten. |
emulatedFormFactor |
Der Formfaktor, den die Emulation verwenden soll. Dieses Feld wurde eingestellt. Verwenden Sie stattdessen „formFactor“. |
locale |
Die Spracheinstellung. |
channel |
Ausführung von Lighthouse, z.B. über die Chrome-Erweiterung oder das npm-Modul. |
formFactor |
Wie Lighthouse diese Ergebnisse in Bezug auf die Bewertung von Leistungsmesswerten und das Überspringen von Tests nur für Mobilgeräte auf Desktop-Computern interpretieren sollte. |
PagespeedVersion
Objekt „Pagespeed Version“.
JSON-Darstellung | |
---|---|
{ "major": string, "minor": string } |
Felder | |
---|---|
major |
Die Hauptversionsnummer von PageSpeed, die zum Generieren dieser Ergebnisse verwendet wird. |
minor |
Die Nebenversionsnummer von PageSpeed, die zum Generieren dieser Ergebnisse verwendet wird. |