Pagespeedapi: runpagespeed

지정된 URL의 페이지에서 PageSpeed 분석을 실행하고 PageSpeed 점수, 페이지 속도를 높이기 위한 추천 목록, 기타 정보를 반환합니다. 지금 사용해 보기

요청

HTTP 요청

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

매개변수

매개변수 이름	값	설명
필수 쿼리 매개변수
url	string	가져와서 분석할 URL
선택적 쿼리 매개변수
category	string	실행할 Lighthouse 카테고리입니다. 지정하지 않으면 성능 카테고리만 실행됩니다. 허용되는 값은 다음과 같습니다. "accessibility" "best-practices" "performance" "seo"
locale	string	형식이 지정된 결과를 현지화하는 데 사용되는 언어
strategy	string	사용할 분석 전략 (데스크톱 또는 모바일)입니다. 기본값은 데스크톱입니다. 허용되는 값은 다음과 같습니다. 'desktop': 데스크톱 브라우저의 URL을 가져오고 분석합니다. 'mobile': 휴대기기용 URL을 가져와 분석합니다.
utm_campaign	string	애널리틱스 캠페인 이름입니다.
utm_source	string	애널리틱스의 캠페인 소스입니다.

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "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
  }
}

속성 이름	값	설명	참고
captchaResult	string	캡차 확인 결과 허용되는 값은 다음과 같습니다. "CAPTCHA_BLOCKING" "CAPTCHA_MATCHED" "CAPTCHA_NEEDED" "CAPTCHA_NOT_NEEDED" "CAPTCHA_UNMATCHED"
kind	string	결과의 종류입니다.
id	string	페이지 리디렉션 (있는 경우)을 따른 후의 문서에 대한 표준화된 최종 URL입니다.
loadingExperience	nested object	최종 사용자의 페이지 로드 경험 측정항목입니다.
loadingExperience.id	string	측정항목이 있는 URL, 패턴 또는 출처입니다.
loadingExperience.metrics	object
loadingExperience.metrics.(key)	object	측정항목의 유형입니다.
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	이 결과를 생성하는 데 사용된 PageSpeed 버전입니다.
version.major	integer	이 결과를 생성하는 데 사용된 PageSpeed의 주요 버전 번호입니다.
version.minor	integer	이 결과를 생성하는 데 사용된 PageSpeed의 부 버전 번호입니다.
loadingExperience.metrics.(key).category	string	허용되는 값은 다음과 같습니다. "AVERAGE" "FAST" "NONE" "SLOW"
loadingExperience.overall_category	string	허용되는 값은 다음과 같습니다. "AVERAGE" "FAST" "NONE" "SLOW"
loadingExperience.initial_url	string
loadingExperience.metrics.(key).percentile	integer
originLoadingExperience	nested object	출처의 집계된 페이지 로드 환경 측정항목
originLoadingExperience.id	string	측정항목이 있는 URL, 패턴 또는 출처입니다.
originLoadingExperience.metrics	object
originLoadingExperience.metrics.(key)	object	측정항목의 유형입니다.
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	허용되는 값은 다음과 같습니다. "AVERAGE" "FAST" "NONE" "SLOW"
originLoadingExperience.overall_category	string	허용되는 값은 다음과 같습니다. "AVERAGE" "FAST" "NONE" "SLOW"
originLoadingExperience.initial_url	string
analysisUTCTimestamp	string	이 분석의 UTC 타임스탬프입니다.
lighthouseResult	nested object	감사 URL의 Lighthouse 응답(객체)입니다.
lighthouseResult.requestedUrl	string	원래 요청된 URL입니다.
lighthouseResult.finalUrl	string	감사된 최종 확인 URL입니다.
lighthouseResult.lighthouseVersion	string	이 LHR을 생성하는 데 사용된 Lighthouse 버전입니다.
lighthouseResult.userAgent	string	이 LHR을 실행하는 데 사용된 사용자 에이전트입니다.
lighthouseResult.fetchTime	string	이 실행을 가져온 시간입니다.
lighthouseResult.environment	object	이 LHR을 만들 때 사용된 환경 설정입니다.
lighthouseResult.environment.networkUserAgent	string
lighthouseResult.environment.hostUserAgent	string
lighthouseResult.environment.benchmarkIndex	double
lighthouseResult.runWarnings[]	list	LHR의 모든 실행 경고 목록입니다. 항상 최소한 `[]`로 출력됩니다.
lighthouseResult.configSettings	object	이 LHR의 구성 설정입니다.
lighthouseResult.configSettings.emulatedFormFactor	string	에뮬레이션에서 사용해야 하는 폼 팩터입니다. 허용되는 값은 다음과 같습니다. "UNKNOWN_FORM_FACTOR" "desktop" "mobile" "none"
lighthouseResult.configSettings.locale	string	언어 설정
lighthouseResult.configSettings.onlyCategories	nested object
lighthouseResult.audits	object	LHR의 감사 지도
lighthouseResult.audits.(key)	nested object
lighthouseResult.audits.(key).id	string	감사의 ID입니다.
lighthouseResult.audits.(key).title	string	사람이 읽을 수 있는 제목입니다.
lighthouseResult.audits.(key).description	string	감사에 대한 설명입니다.
lighthouseResult.audits.(key).score	nested object
lighthouseResult.audits.(key).scoreDisplayMode	string	열거된 점수 표시 모드입니다. 허용되는 값은 다음과 같습니다. "SCORE_DISPLAY_MODE_UNSPECIFIED" "binary" "error" "informative" "manual" "not_applicable" "numeric"
lighthouseResult.audits.(key).displayValue	string	이 감사에 대해 UI에 표시되어야 하는 값입니다.
lighthouseResult.audits.(key).explanation	string	감사의 오류에 대한 설명입니다.
lighthouseResult.audits.(key).errorMessage	string	감사 내에서 발생한 오류의 오류 메시지입니다.
lighthouseResult.audits.(key).warnings	nested object
lighthouseResult.audits.(key).details	object	감사의 자유 형식 세부정보 섹션입니다.
lighthouseResult.audits.(key).details.(key)	any value
lighthouseResult.categories	object	LHR의 카테고리 지도
lighthouseResult.categories.(key)	nested object
lighthouseResult.categories.(key).id	string	카테고리의 문자열 식별자입니다.
lighthouseResult.categories.(key).title	string	카테고리의 사용자 친화적인 이름입니다.
lighthouseResult.categories.(key).description	string	카테고리 및 중요성에 대한 자세한 설명
lighthouseResult.categories.(key).score	nested object
lighthouseResult.categories.(key).manualDescription	string	카테고리의 수동 감사에 대한 설명입니다.
lighthouseResult.categories.(key).auditRefs[]	list	이 카테고리의 모든 감사 구성원에 대한 참조 배열입니다.
lighthouseResult.categories.(key).auditRefs[].id	string	감사 참조 ID입니다.
lighthouseResult.categories.(key).auditRefs[].weight	double	전체 카테고리 점수에 대한 이 감사 점수의 가중치입니다.
lighthouseResult.categories.(key).auditRefs[].group	string	감사가 속한 카테고리 그룹입니다 (선택사항).
lighthouseResult.categoryGroups	object	LHR의 카테고리 그룹 지도입니다.
lighthouseResult.categoryGroups.(key)	object
lighthouseResult.categoryGroups.(key).title	string
lighthouseResult.categoryGroups.(key).description	string
lighthouseResult.runtimeError	object	발생한 런타임 오류의 코드와 메시지가 포함된 객체입니다.
lighthouseResult.runtimeError.code	string	허용되는 값은 다음과 같습니다. "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	이 LHR의 타이밍 정보입니다.
lighthouseResult.timing.total	double	Lighthouse 실행의 총 지속 시간
lighthouseResult.i18n	object	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

기능을 사용해 보세요.

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.