Method: pagespeedapi.runpagespeed

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

enum (Category)

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

string

Die Sprache, die zur Lokalisierung formatierter Ergebnisse verwendet wird
strategy

enum (Strategy)

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

string

Erforderlich. Die URL zum Abrufen und Analysieren
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

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

string

Art des Ergebnisses.
captchaResult

string

Ergebnis der Captcha-Bestätigung
id

string

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

object (PagespeedApiLoadingExperienceV5)

Messwerte zum Seitenaufbau der Endnutzer.
originLoadingExperience

object (PagespeedApiLoadingExperienceV5)

Messwerte für den aggregierten Seitenaufbau 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 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 (UserPageLoadMetricV5)
    },
    ...
  },
  "overall_category": string,
  "initial_url": string,
  "origin_fallback": boolean
}
Felder
id

string

Die URL, das Muster oder der Ursprung, von dem bzw. dem die Messwerte stammen.
metrics

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

Die Map 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 für Menschen lesbare Geschwindigkeits-„Kategorie“ 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 geklärte URL, die geprüft wurde.
lighthouseVersion

string

Die Lighthouse-Version, 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))

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

object (Environment)

Umgebungseinstellungen, die beim Erstellen dieses LHR verwendet wurden.
runWarnings

array (ListValue format)

Liste aller Ausführungswarnungen im LHR. Wird immer in mindestens [] 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 diese LHR.
configSettings

object (ConfigSettings)

Die Konfigurationseinstellungen für dieses 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 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

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

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 einer Prüfung oder einem Messwert, bei dem ein Fehler aufgetreten ist.
warningHeader

string

Das Label über einer Aufzählungsliste mit 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 oben zeigt eine Liste von Prüfungen, die nicht für eine Seite gelten.
manualAuditsGroupTitle

string

Die Überschrift oben zeigt eine 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 Erklärung 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, aus dem hervorgeht, 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 Stack-Pack-Symbol.
descriptions

map (key: string, value: string)

Die Empfehlungsstrings für das Stack Pack.

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 menschenlesbare Meldung, in der der Fehlercode erläutert wird.

Kategorien

Die Kategorien in einem Lighthouse-Durchlauf.

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 in Bezug auf Best Practices enthält
seo

object (LighthouseCategoryV5)

Die Kategorie Suchmaschinenoptimierung (SEO) mit allen SEO-Audits.
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 leicht zu merkende 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 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

string

Die Audit-Ref.-ID.
weight

number

Die Gewichtung, die die Punktzahl dieses Audits auf die Gesamtbewertung der Kategorie stützt.
group

string

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

number

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

value (Value format)

Liste der Kategorien von Audits, die bei der Ausführung durchgeführt werden sollten.
emulatedFormFactor
(deprecated)

string

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

string

Die Spracheinstellung.
channel

string

Ausführung von Lighthouse, z.B. über die Chrome-Erweiterung oder das npm-Modul.
formFactor

string

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

string

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

string

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