Method: pagespeedapi.runpagespeed

Führt eine PageSpeed-Analyse auf der Seite unter der angegebenen URL durch und gibt PageSpeed-Bewertungen, eine Liste mit Vorschlägen zur Beschleunigung dieser Seite und 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

enum (Category)

Eine auszuführende Lighthouse-Kategorie: Wenn keine angegeben sind, wird nur die Kategorie „Leistung“ ausgeführt.

locale

string

Das Gebietsschema, das zum Lokalisieren formatierter Ergebnisse verwendet wird

strategy

enum (Strategy)

Die zu verwendende Analysestrategie (Computer oder Mobilgeräte). Computer ist die Standardeinstellung.

url

string

Erforderlich. Die URL, die abgerufen und analysiert werden soll

utm_campaign

string

Kampagnenname für Analysen.

utm_source

string

Kampagnenquelle für Analysen.

captchaToken

string

Das beim Ausfüllen eines Captcha übergebene Captcha-Token.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Das Pagespeed API-Antwortobjekt.

JSON-Darstellung
{
  "kind": string,
  "captchaResult": string,
  "id": string,
  "loadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "originLoadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "analysisUTCTimestamp": string,
  "lighthouseResult": {
    object (LighthouseResultV5)
  },
  "version": {
    object (PagespeedVersion)
  }
}
Felder
kind

string

Art des Ergebnisses.

captchaResult

string

Ergebnis der Captcha-Überprüfung

id

string

Kanonisierte und finale URL für das Dokument nach Folgen von Seitenweiterleitungen (falls vorhanden).

loadingExperience

object (PagespeedApiLoadingExperienceV5)

Messwerte von Endnutzern beim Laden von Seiten.

originLoadingExperience

object (PagespeedApiLoadingExperienceV5)

Messwerte der aggregierten Seitenladeerfahrung des Ursprungs

analysisUTCTimestamp

string

Der UTC-Zeitstempel dieser Analyse.

lighthouseResult

object (LighthouseResultV5)

Lighthouse-Antwort für die Audit-URL als Objekt.

version

object (PagespeedVersion)

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 aufgelisteten Kategorien, die analysiert werden sollen.

Enums
CATEGORY_UNSPECIFIED Standardkategorie UNDEFINED.
ACCESSIBILITY Barrierefreiheit (a11y), Kategorie zur Verfügbarkeit einer Website, die für alle Nutzenden zugänglich ist.
BEST_PRACTICES Best Practices, Kategorie in Bezug auf die Konformität einer Website mit Best Practices für das Web.
PERFORMANCE Leistung, Kategorie in Bezug auf die Leistung einer Website.
SEO Suchmaschinenoptimierung (Search Engine Optimization, SEO): Kategorie, die angibt, wie eine Website von Suchmaschinen indexiert werden kann.

Strategie

Die Geräte-Laufstrategie, die bei der Analyse verwendet werden soll.

Enums
STRATEGY_UNSPECIFIED NICHT FESTGELEGT.
DESKTOP Rufen Sie die URL für Desktop-Browser ab und analysieren Sie sie.
MOBILE Rufen Sie die URL für Mobilgeräte ab und analysieren Sie sie.

PagespeedApiLoadingExperienceV5

Das Objekt zum Laden der Nutzererfahrung in Chrome, das Aufschlüsselungen der CrUX-Daten enthält.

JSON-Darstellung
{
  "id": string,
  "metrics": {
    string: {
      object (UserPageLoadMetricV5)
    },
    ...
  },
  "overall_category": string,
  "initial_url": string,
  "origin_fallback": boolean
}
Felder
id

string

Die URL, das Muster oder der Ursprung, auf dem sich die Messwerte befinden.

metrics

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

Die Zuordnung von <metrics, data>.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

overall_category

string

Die menschenlesbare Geschwindigkeitskategorie der ID an.

initial_url

string

Die angeforderte URL, die sich von der aufgelösten „id“ unterscheiden kann.

origin_fallback

boolean

Der Wert ist „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 (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)
  }
}
Felder
fetchTime

string

Die Uhrzeit, zu der diese Ausführung abgerufen wurde.

requestedUrl

string

Die ursprünglich angeforderte URL.

finalUrl

string

Die endgültig aufgelöste URL, die geprüft wurde.

lighthouseVersion

string

Die Leuchtturmversion, mit der dieses LHR generiert wurde.

i18n

object (I18n)

Die Internationalisierungsstrings, die zum Rendern des LHR erforderlich sind.

userAgent

string

Der User-Agent, der zum Ausführen dieses LHR verwendet wurde.

audits

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

Karte der Audits im LHR.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

categoryGroups

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

Zuordnung von Kategoriegruppen im LHR.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

stackPacks[]

object (StackPack)

Die Stackpack-Hinweisstrings.

environment

object (Environment)

Umgebungseinstellungen, die bei der Erstellung dieses LHR verwendet wurden.

runWarnings

array (ListValue format)

Liste aller Ausführungswarnungen im LHR. Wird immer bis mindestens [] ausgegeben.

runtimeError

object (RuntimeError)

Eine allgemeine Fehlermeldung, die auf ein schwerwiegendes Problem hinweist, dass dieses Lighthouse-Ergebnis möglicherweise verworfen werden muss.

categories

object (Categories)

Karte der Kategorien im LHR.

timing

object (Timing)

Zeitangaben für diese LHR.

configSettings

object (ConfigSettings)

Die Konfigurationseinstellungen für diese LHR.

L18n

Nachricht mit den i18n-Daten für das LHR – Version 1.

JSON-Darstellung
{
  "rendererFormattedStrings": {
    object (RendererFormattedStrings)
  }
}
Felder
rendererFormattedStrings

object (RendererFormattedStrings)

Internationalisierte Strings, die für die 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

string

Der Haftungsausschluss, der unter einem Leistungsmesswert angezeigt wird.

opportunityResourceColumnLabel

string

Die Überschrift für die geschätzten Einsparungen beim Seitenaufbau bei einer Prüfung.

opportunitySavingsColumnLabel

string

Überschrift für die geschätzten Einsparungen beim Seitenaufbau bei Optimierungsmöglichkeiten.

errorMissingAuditInfo

string

Der Fehlerstring, der neben einer fehlerhaften Prüfung angezeigt wird.

errorLabel

string

Das Label, das neben einem Audit oder einem Messwert angezeigt wird, bei dem ein Fehler aufgetreten ist.

warningHeader

string

Das Label über einer Aufzählung von Warnungen.

auditGroupExpandTooltip

string

Der Text der Kurzinfo auf einem maximierbaren Chevron-Symbol.

passedAuditsGroupTitle

string

Die Überschrift, die über einer Liste der bestandenen Prüfungen angezeigt wird.

notApplicableAuditsGroupTitle

string

Die Überschrift über einer Liste von Audits, die nicht für eine Seite gelten.

manualAuditsGroupTitle

string

Die Überschrift über einer Liste von Prüfungen, die bei der Ausführung nicht computergestützt wurden.

toplevelWarningsMessage

string

Das Label vor wichtigen Warnungen, die möglicherweise einen ganzen Bericht ungültig gemacht haben.

scorescaleLabel

string

Die Beschriftung zur Erläuterung der Bewertungsskala (0–49, 50–89, 90–100).

crcLongestDurationLabel

string

Das Label für Werte, das in der Zusammenfassung kritischer Anfrageketten angezeigt wird.

crcInitialNavigation

string

Das Label für die erste Anfrage in einer kritischen Anfragekette.

lsPerformanceCategoryDescription

string

Der unter „Leistung“ angezeigte Haftungsausschluss, der darauf hinweist, dass das Werbenetzwerk variieren kann.

labDataTitle

string

Der Titel der Kategorie für die Lab-Datenleistung.

StackPack

Nachricht mit Stackpack-Informationen.

JSON-Darstellung
{
  "id": string,
  "title": string,
  "iconDataURL": string,
  "descriptions": {
    string: string,
    ...
  }
}
Felder
id

string

Die Stackpack-ID.

title

string

Titel des Stapelpakets.

iconDataURL

string

Der Daten-URI des Stackpack-Symbols.

descriptions

map (key: string, value: string)

Die Stackpack-Hinweisstrings.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Umgebung

Nachricht zur Umgebungskonfiguration für eine Lighthouse-Ausführung.

JSON-Darstellung
{
  "networkUserAgent": string,
  "hostUserAgent": string,
  "benchmarkIndex": number
}
Felder
networkUserAgent

string

Der User-Agent-String, der über das Netzwerk gesendet wurde.

hostUserAgent

string

Der User-Agent-String der verwendeten Chrome-Version.

benchmarkIndex

number

Die Benchmark-Indexnummer, die eine grobe Geräteklasse angibt.

RuntimeError

Nachricht mit einer Laufzeitfehlerkonfiguration.

JSON-Darstellung
{
  "code": string,
  "message": string
}
Felder
code

string

Der aufgelistete Lighthouse-Fehlercode.

message

string

Eine menschenlesbare Meldung, die den Fehlercode erklärt.

Kategorien

Die Kategorien in einer Lighthouse-Anzeige werden ausgeführt.

JSON-Darstellung
{
  "accessibility": {
    object (LighthouseCategoryV5)
  },
  "best-practices": {
    object (LighthouseCategoryV5)
  },
  "seo": {
    object (LighthouseCategoryV5)
  },
  },
  "performance": {
    object (LighthouseCategoryV5)
  }
}
Felder
accessibility

object (LighthouseCategoryV5)

Die Kategorie „Barrierefreiheit“, die alle Prüfungen zur Barrierefreiheit enthält.

best-practices

object (LighthouseCategoryV5)

Die Kategorie „Best Practices“, die alle Audits im Zusammenhang mit Best Practices enthält.

seo

object (LighthouseCategoryV5)

Die Kategorie für Suchmaschinenoptimierung (SEO), die alle SEO-bezogenen Audits enthält.

performance

object (LighthouseCategoryV5)

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

string

Die Zeichenfolgen-ID der Kategorie.

title

string

Der nutzerfreundliche Name der Kategorie.

description

string

Eine detailliertere Beschreibung der Kategorie und ihrer Wichtigkeit.

manualDescription

string

Eine Beschreibung der manuellen Prüfungen in der Kategorie.

auditRefs[]

object (AuditRefs)

Ein Array mit Verweisen auf alle Auditmitglieder dieser Kategorie.

score

value (Value format)

Die Gesamtpunktzahl der Kategorie, der gewichtete Durchschnitt aller Prüfungen. (Die Bewertung der Kategorie kann null sein.)

AuditRefs

Ein leichter Verweis auf einen Audit nach ID, mit dem Audits in einer bestimmten Kategorie gruppiert und gewichtet werden.

JSON-Darstellung
{
  "id": string,
  "weight": number,
  "group": string
}
Felder
id

string

Die Audit-Referenz-ID.

weight

number

Die Gewichtung, die die Bewertung dieses Audits in der Gesamtkategoriebewertung hat.

group

string

Die Kategoriegruppe, zu der die Prüfung gehört (optional).

Timing

Nachricht mit den Leistungszeitdaten für die Lighthouse-Ausführung.

JSON-Darstellung
{
  "total": number
}
Felder
total

number

Die Gesamtdauer der Ausführung 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

value (Value format)

Liste der Kategorien von Audits, die durchgeführt werden sollen.

emulatedFormFactor
(deprecated)

string

Der Formfaktor, den die Emulation verwenden soll. Dieses Feld wurde eingestellt. Verwenden Sie stattdessen „formFactor“.

locale

string

Die Einstellung für das Gebietsschema.

channel

string

So wurde Lighthouse ausgeführt, z.B. aus der Chrome-Erweiterung oder aus dem npm-Modul.

formFactor

string

Wie Lighthouse diese Ausführung im Hinblick auf die Bewertung von Leistungsmesswerten und das Überspringen von Tests nur für Mobilgeräte auf Computern interpretieren sollte

PagespeedVersion

Das Seitenaufruf-Versionsobjekt.

JSON-Darstellung
{
  "major": string,
  "minor": string
}
Felder
major

string

Die Hauptversionsnummer von PageSpeed, die zum Generieren dieser Ergebnisse verwendet wurde.

minor

string

Die Nebenversionsnummer von PageSpeed, die zum Generieren dieser Ergebnisse verwendet wurde.