Pagespeedapi: runpagespeed

Przeprowadza analizę PageSpeed na stronie pod podanym adresem URL i zwraca wyniki PageSpeed, listę sugestii dotyczących przyspieszenia strony oraz inne informacje. Wypróbuj teraz

Żądanie

Żądanie HTTP

GET https://www.googleapis.com/pagespeedonline/v5/runPagespeed

Parametry

Nazwa parametru Wartość Opis
Wymagane parametry zapytania
url string Adres URL do pobrania i analizy
Opcjonalne parametry zapytania
category string Kategoria Lighthouse do uruchomienia. Jeśli nie podasz żadnej kategorii, uruchomiona zostanie tylko kategoria Wydajność.

Dopuszczalne wartości:
  • „accessibility”
  • „best-practices”
  • „performance”
  • „seo”
locale string Język używany do lokalizowania sformatowanych wyników.
strategy string Strategia analizy (komputer lub urządzenie mobilne). Wartość domyślna to „komputer”.

Akceptowane wartości:
  • „desktop”: pobierz i przeanalizuj adres URL dla przeglądarek na komputery.
  • „mobile”: pobierz i przeanalizuj adres URL pod kątem urządzeń mobilnych.
utm_campaign string Nazwa kampanii na potrzeby Analytics.
utm_source string Źródło kampanii w Analytics.

Treść żądania

Nie podawaj treści żądania w przypadku tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:

{
  "captchaResult": string,
  "kind": "pagespeedonline#result",
  "id": string,
  "loadingExperience": {
    "id": string,
    "metrics": {
      (key): {
        "percentile": integer,
        "distributions": [
          {
            "min": integer,
            "max": integer,
            "proportion": double
          }
        ],
        "category": string
      }
    },
    "overall_category": string,
    "initial_url": string
  },
  "originLoadingExperience": {
    "id": string,
    "metrics": {
      (key): {
        "percentile": integer,
        "distributions": [
          {
            "min": integer,
            "max": integer,
            "proportion": double
          }
        ],
        "category": string
      }
    },
    "overall_category": string,
    "initial_url": string
  },
  "lighthouseResult": {
    "requestedUrl": string,
    "finalUrl": string,
    "lighthouseVersion": string,
    "userAgent": string,
    "fetchTime": string,
    "environment": {
      "networkUserAgent": string,
      "hostUserAgent": string,
      "benchmarkIndex": double
    },
    "runWarnings": [
      (value)
    ],
    "configSettings": {
      "emulatedFormFactor": string,
      "locale": string,
      "onlyCategories": (value),
      "onlyCategories": (value)
    },
    "audits": {
      (key): {
        "id": string,
        "title": string,
        "description": string,
        "score": (value),
        "score": (value),
        "scoreDisplayMode": string,
        "displayValue": string,
        "explanation": string,
        "errorMessage": string,
        "warnings": (value),
        "warnings": (value),
        "details": {
          (key): (value)
        }
      }
    },
    "categories": {
      (key): {
        "id": string,
        "title": string,
        "description": string,
        "score": (value),
        "score": (value),
        "manualDescription": string,
        "auditRefs": [
          {
            "id": string,
            "weight": double,
            "group": string
          }
        ]
      }
    },
    "categoryGroups": {
      (key): {
        "title": string,
        "description": string
      }
    },
    "runtimeError": {
      "code": string,
      "message": string
    },
    "timing": {
      "total": double
    },
    "i18n": {
      "rendererFormattedStrings": {
        "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
      }
    }
  },
  "analysisUTCTimestamp": string,
  "version": {
    "major": integer,
    "minor": integer
  }
}
Nazwa usługi Wartość Opis Uwagi
captchaResult string Wynik weryfikacji CAPTCHA.

Akceptowane wartości:
  • „CAPTCHA_BLOCKING”
  • „CAPTCHA_MATCHED”
  • „CAPTCHA_NEEDED”
  • „CAPTCHA_NOT_NEEDED”
  • „CAPTCHA_UNMATCHED”
kind string Rodzaj wyniku.
id string Kanoniczny i końcowy adres URL dokumentu po przekierowaniach (jeśli występują).
loadingExperience nested object Dane dotyczące wrażeń użytkowników związanych z wczytywaniem strony.
loadingExperience.id string Adres URL, wzorzec lub źródło, w którym znajdują się dane.
loadingExperience.metrics object
loadingExperience.metrics.(key) object Typ danych.
loadingExperience.metrics.(key).distributions[] list
loadingExperience.metrics.(key).distributions[].min integer
loadingExperience.metrics.(key).distributions[].max integer
loadingExperience.metrics.(key).distributions[].proportion double
version object Wersja PageSpeed użyta do wygenerowania tych wyników.
version.major integer Numer wersji głównej PageSpeed użytej do wygenerowania tych wyników.
version.minor integer Numer wersji podrzędnej PageSpeed użytej do wygenerowania tych wyników.
loadingExperience.metrics.(key).category string

Akceptowane wartości:
  • „AVERAGE”
  • „FAST”
  • „NONE”
  • „SLOW”
loadingExperience.overall_category string

Akceptowane wartości:
  • „AVERAGE”
  • „FAST”
  • „NONE”
  • „SLOW”
loadingExperience.initial_url string
loadingExperience.metrics.(key).percentile integer
originLoadingExperience nested object Dane dotyczące zbiorczej jakości wczytywania stron w przypadku danej domeny
originLoadingExperience.id string Adres URL, wzorzec lub źródło, w którym znajdują się dane.
originLoadingExperience.metrics object
originLoadingExperience.metrics.(key) object Typ danych.
originLoadingExperience.metrics.(key).percentile integer
originLoadingExperience.metrics.(key).distributions[] list
originLoadingExperience.metrics.(key).distributions[].min integer
originLoadingExperience.metrics.(key).distributions[].max integer
originLoadingExperience.metrics.(key).distributions[].proportion double
originLoadingExperience.metrics.(key).category string

Akceptowane wartości:
  • „AVERAGE”
  • „FAST”
  • „NONE”
  • „SLOW”
originLoadingExperience.overall_category string

Akceptowane wartości:
  • „AVERAGE”
  • „FAST”
  • „NONE”
  • „SLOW”
originLoadingExperience.initial_url string
analysisUTCTimestamp string Sygnatura czasowa UTC tej analizy.
lighthouseResult nested object Odpowiedź Lighthouse na adres URL audytu w formie obiektu.
lighthouseResult.requestedUrl string Oryginalny adres URL, którego dotyczy prośba.
lighthouseResult.finalUrl string Końcowy rozwiązany adres URL, który został poddany audytowi.
lighthouseResult.lighthouseVersion string Wersja Lighthouse, która została użyta do wygenerowania tego raportu LHR.
lighthouseResult.userAgent string Klient użytkownika, który został użyty do uruchomienia tego raportu LHR.
lighthouseResult.fetchTime string Czas pobrania tego przebiegu.
lighthouseResult.environment object Ustawienia środowiska użyte podczas tworzenia tego LHR.
lighthouseResult.environment.networkUserAgent string
lighthouseResult.environment.hostUserAgent string
lighthouseResult.environment.benchmarkIndex double
lighthouseResult.runWarnings[] list Lista wszystkich ostrzeżeń dotyczących uruchomienia w LHR. Zawsze będzie zwracać co najmniej `[]`.
lighthouseResult.configSettings object Ustawienia konfiguracji tego LHR.
lighthouseResult.configSettings.emulatedFormFactor string Format, którego ma używać emulacja.

Akceptowane wartości:
  • „UNKNOWN_FORM_FACTOR”
  • „desktop”
  • „mobile”
  • „none”
lighthouseResult.configSettings.locale string Ustawienie języka
lighthouseResult.configSettings.onlyCategories nested object
lighthouseResult.audits object Mapa kontroli w LHR.
lighthouseResult.audits.(key) nested object
lighthouseResult.audits.(key).id string Identyfikator audytu.
lighthouseResult.audits.(key).title string Tytuł zrozumiały dla człowieka.
lighthouseResult.audits.(key).description string Opis audytu.
lighthouseResult.audits.(key).score nested object
lighthouseResult.audits.(key).scoreDisplayMode string Wyliczony tryb wyświetlania wyniku.

Akceptowane wartości:
  • „SCORE_DISPLAY_MODE_UNSPECIFIED”
  • „binary”
  • „error”
  • „informative”
  • „manual”
  • „not_applicable”
  • „numeric”
lighthouseResult.audits.(key).displayValue string Wartość, która powinna być wyświetlana w interfejsie w przypadku tego audytu.
lighthouseResult.audits.(key).explanation string Wyjaśnienie błędów w audycie.
lighthouseResult.audits.(key).errorMessage string Komunikat o błędzie pochodzący z błędu zgłoszonego w ramach kontroli.
lighthouseResult.audits.(key).warnings nested object
lighthouseResult.audits.(key).details object Sekcja szczegółów kontroli w formie dowolnej.
lighthouseResult.audits.(key).details.(key) any value
lighthouseResult.categories object Mapa kategorii w LHR.
lighthouseResult.categories.(key) nested object
lighthouseResult.categories.(key).id string Identyfikator kategorii w formie ciągu znaków.
lighthouseResult.categories.(key).title string Nazwa kategorii zrozumiała dla człowieka.
lighthouseResult.categories.(key).description string Bardziej szczegółowy opis kategorii i jej znaczenia.
lighthouseResult.categories.(key).score nested object
lighthouseResult.categories.(key).manualDescription string Opis audytów ręcznych w danej kategorii.
lighthouseResult.categories.(key).auditRefs[] list Tablica odwołań do wszystkich członków audytu w tej kategorii.
lighthouseResult.categories.(key).auditRefs[].id string Identyfikator referencyjny kontroli.
lighthouseResult.categories.(key).auditRefs[].weight double Waga, jaką wynik tego audytu ma na ogólną ocenę kategorii.
lighthouseResult.categories.(key).auditRefs[].group string Grupa kategorii, do której należy audyt (opcjonalnie).
lighthouseResult.categoryGroups object Mapa grup kategorii w LHR.
lighthouseResult.categoryGroups.(key) object
lighthouseResult.categoryGroups.(key).title string
lighthouseResult.categoryGroups.(key).description string
lighthouseResult.runtimeError object Obiekt zawierający kod i komunikat o błędach czasu działania.
lighthouseResult.runtimeError.code string

Akceptowane wartości:
  • „ERRORED_DOCUMENT_REQUEST”
  • „FAILED_DOCUMENT_REQUEST”
  • „INSECURE_DOCUMENT_REQUEST”
  • „INVALID_SPEEDLINE”
  • „NO_DCL”
  • „NO_DOCUMENT_REQUEST”
  • „NO_ERROR”
  • „NO_FCP”
  • „NO_NAVSTART”
  • „NO_SCREENSHOTS”
  • „NO_SPEEDLINE_FRAMES”
  • „NO_TRACING_STARTED”
  • „PARSING_PROBLEM”
  • „PROTOCOL_TIMEOUT”
  • „READ_FAILED”
  • „SPEEDINDEX_OF_ZERO”
  • „TRACING_ALREADY_STARTED”
  • „UNKNOWN_ERROR”
lighthouseResult.runtimeError.message string
lighthouseResult.timing object Informacje o czasie dla tego LHR.
lighthouseResult.timing.total double Całkowity czas trwania uruchomienia Lighthouse
lighthouseResult.i18n object Ciągi znaków internacjonalizacji wymagane do wyrenderowania LHR.
lighthouseResult.i18n.rendererFormattedStrings object
lighthouseResult.i18n.rendererFormattedStrings.varianceDisclaimer string
lighthouseResult.i18n.rendererFormattedStrings.opportunityResourceColumnLabel string
lighthouseResult.i18n.rendererFormattedStrings.opportunitySavingsColumnLabel string
lighthouseResult.i18n.rendererFormattedStrings.errorMissingAuditInfo string
lighthouseResult.i18n.rendererFormattedStrings.errorLabel string
lighthouseResult.i18n.rendererFormattedStrings.warningHeader string
lighthouseResult.i18n.rendererFormattedStrings.auditGroupExpandTooltip string
lighthouseResult.i18n.rendererFormattedStrings.passedAuditsGroupTitle string
lighthouseResult.i18n.rendererFormattedStrings.notApplicableAuditsGroupTitle string
lighthouseResult.i18n.rendererFormattedStrings.manualAuditsGroupTitle string
lighthouseResult.i18n.rendererFormattedStrings.toplevelWarningsMessage string
lighthouseResult.i18n.rendererFormattedStrings.scorescaleLabel string
lighthouseResult.i18n.rendererFormattedStrings.crcLongestDurationLabel string
lighthouseResult.i18n.rendererFormattedStrings.crcInitialNavigation string
lighthouseResult.i18n.rendererFormattedStrings.lsPerformanceCategoryDescription string
lighthouseResult.i18n.rendererFormattedStrings.labDataTitle string

Wypróbuj

Użyj narzędzia APIs Explorer poniżej, aby wywołać tę metodę na danych na żywo i zobaczyć odpowiedź.