Method: pagespeedapi.runpagespeed

Führt eine PageSpeed-Analyse auf der Seite unter der angegebenen URL durch und gibt PageSpeed-Ergebnisse, 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

enum (Category)

Eine Lighthouse-Kategorie, die ausgeführt werden soll. Wenn keines angegeben ist, wird nur die Leistungskategorie ausgeführt.
locale

string

Die Sprache, die zur Lokalisierung formatierter Ergebnisse verwendet wird
strategy

enum (Strategy)

Die zu verwendende Analysestrategie (Desktop oder Mobilgerät) und Desktop ist die Standardeinstellung
url

string

Erforderlich. URL, die abgerufen und analysiert werden soll
utm_campaign

string

Kampagnenname für Analytics.
utm_source

string

Kampagnenquelle für Analysen.
captchaToken

string

Das Captcha-Token, das beim Ausfüllen des Captcha übergeben wird.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

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

Das Antwortobjekt der Pagespeed API.

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

Das Ergebnis der Captcha-Verifizierung
id

string

Die kanonische und finale URL für das Dokument, nachdem Seitenweiterleitungen gefolgt sind (falls vorhanden).
loadingExperience

object (PagespeedApiLoadingExperienceV5)

Messwerte zum Laden von Seiten durch Endnutzer.
originLoadingExperience

object (PagespeedApiLoadingExperienceV5)

Messwerte der aggregierten Erfahrung beim Seitenaufbau im Ursprungsserver
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 Aufzählungskategorien, die analysiert werden sollen.

Enums
CATEGORY_UNSPECIFIED Standardkategorie NICHT DEFINIERT.
ACCESSIBILITY Barrierefreiheit (A11y), Kategorie, die sich auf die Fähigkeit einer Website bezieht, für alle Nutzenden zugänglich zu sein.
BEST_PRACTICES Best Practices, Kategorie zur Einhaltung der Best Practices für das Web.
PERFORMANCE Leistung, Kategorie, die sich auf die Leistung einer Website bezieht.
PWA Progressive Web-App (PWA) in Bezug auf die Fähigkeit einer Website, als PWA ausgeführt zu werden.
SEO Suchmaschinenoptimierung (SEO), 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 bei 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-Ladevorgangsobjekt, das CrUX-Datenaufschlüsselungen 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.
initial_url

string

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

boolean

„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

Der Zeitpunkt, zu dem diese Ausführung abgerufen wurde.
requestedUrl

string

Die ursprünglich angeforderte URL.
finalUrl

string

Die endgültige geprüfte URL.
lighthouseVersion

string

Die Lighthouse-Version, die zum Generieren dieses LHR verwendet 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))

Karte der 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 Stack Pack-Ratationsstrings.
environment

object (Environment)

Umgebungseinstellungen, die beim Erstellen dieses LHR verwendet wurden.
runWarnings

array (ListValue format)

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

object (RuntimeError)

Eine Fehlermeldung auf oberster Ebene, die gegebenenfalls 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 diesen LHR.
configSettings

object (ConfigSettings)

Die Konfigurationseinstellungen für dieses LHR.

L18n

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

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

object (RendererFormattedStrings)

Internationalisierte Strings, die in configSettings gemäß der Sprache 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 unter dem Wert eines Leistungsmesswertes eingeblendete Haftungsausschluss.
opportunityResourceColumnLabel

string

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

string

Die Überschrift für die geschätzten Einsparungen beim Seitenaufbau durch Empfehlungensprüfungen.
errorMissingAuditInfo

string

Der Fehlerstring, der neben einem fehlerhaften Audit angezeigt wird.
errorLabel

string

Das Label neben einem Audit oder Messwert, bei dem ein Fehler aufgetreten ist.
warningHeader

string

Das Label, das über einer Aufzählungsliste mit Warnungen angezeigt wird.
auditGroupExpandTooltip

string

Der Text der Kurzinfo auf einem maximierbaren Chevron-Symbol.
passedAuditsGroupTitle

string

Die Überschrift, die über einer Liste der bestandenen Audits angezeigt wird.
notApplicableAuditsGroupTitle

string

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

string

Die Überschrift über einer Liste von Audits, die bei der Ausführung nicht computergeneriert wurden.
toplevelWarningsMessage

string

Das Label, das vor wichtigen Warnungen angezeigt wurde, durch die möglicherweise ein gesamter Bericht für ungültig erklärt wurde.
scorescaleLabel

string

Das Label zur Erläuterung der Bewertungsskala (0–49, 50–89, 90–100).
crcLongestDurationLabel

string

Das Label für Werte, die in der Zusammenfassung der Ketten kritischer Anfragen angezeigt werden.
crcInitialNavigation

string

Das Label für die erste Anfrage in einer Kette kritischer Anfragen.
lsPerformanceCategoryDescription

string

Der unter „Leistung“ angezeigte Haftungsausschluss, in dem erklärt wird, dass das Netzwerk variieren kann.
labDataTitle

string

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

string

Die Stack-Pack-ID.
title

string

Der Titel des Stapelpakets.
iconDataURL

string

Der Daten-URI für das Stapelpaketsymbol.
descriptions

map (key: string, value: string)

Die Ratgeber des Stack Packs.

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

Umgebung

Nachricht mit 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 die ungefähre Geräteklasse angibt.

RuntimeError

Nachricht mit einer Laufzeitfehlerkonfiguration.

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

string

Der aufgezählte Lighthouse-Fehlercode.
message

string

Eine für Menschen lesbare Nachricht zur Erläuterung des Fehlercodes.

Kategorien

Die Kategorien in einer Lighthouse-Ausführung.

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

object (LighthouseCategoryV5)

Die Kategorie der Barrierefreiheit, die alle Prüfungen zur Barrierefreiheit enthält.
best-practices

object (LighthouseCategoryV5)

Die Kategorie „Best Practices“ mit allen Audits im Zusammenhang mit Best Practices.
seo

object (LighthouseCategoryV5)

Die Kategorie „Suchmaschinenoptimierung (SEO)“, die alle SEO-bezogenen Prüfungen enthält.
pwa

object (LighthouseCategoryV5)

Die Kategorie „Progressive Web-Apps“ (PWA) mit allen Audits im Zusammenhang mit PWAs.
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 String-ID der Kategorie.
title

string

Der nutzerfreundliche Name der Kategorie.
description

string

Eine detailliertere Beschreibung der Kategorie und ihrer Bedeutung.
manualDescription

string

Eine Beschreibung der manuellen Audits in der Kategorie.
auditRefs[]

object (AuditRefs)

Ein Array von Referenzen zu allen Audit-Mitgliedern dieser Kategorie.
score

value (Value format)

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

AuditRefs

Ein einfacher Verweis auf ein 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-Ref.-ID.
weight

number

Die Gewichtung der Bewertung dieser Prüfung auf die Gesamtbewertung der Kategorie.
group

string

Die Kategoriegruppe, zu der das Audit gehört (optional).

Dauer

Nachricht mit den Daten zum Leistungszeitpunkt für die Lighthouse-Ausführung.

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

number

Die Gesamtdauer der Lighthouse-Ausführung.

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 sollten.
emulatedFormFactor
(deprecated)

string

Der Formfaktor, den die Emulation verwenden soll. Dieses Feld ist veraltet. Verwenden Sie stattdessen „formFactor“.
locale

string

Die Spracheinstellung.
channel

string

Ausführung von Lighthouse, z. B. über die Chrome-Erweiterung oder über das 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 Desktop-Computern interpretieren sollte

PagespeedVersion

Das PageSpeed Version-Objekt.

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

string

Die Hauptversionsnummer von PageSpeed, mit der diese Ergebnisse generiert werden.
minor

string

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