지정된 URL의 페이지에 대해 PageSpeed 분석을 실행하고 PageSpeed 점수, 페이지 속도를 높이기 위한 제안사항 목록 및 기타 정보를 반환합니다. 지금 사용해 보기
요청
HTTP 요청
GET https://www.googleapis.com/pagespeedonline/v5/runPagespeed
매개변수
매개변수 이름 | 값 | 설명 |
---|---|---|
필수 쿼리 매개변수 | ||
url |
string |
가져오고 분석할 URL입니다. |
선택적 쿼리 매개변수 | ||
category |
string |
실행할 Lighthouse 카테고리 카테고리를 지정하지 않으면 실적 카테고리만 실행됩니다.
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
locale |
string |
형식이 지정된 결과를 현지화하는 데 사용되는 언어 |
strategy |
string |
사용할 분석 전략 (데스크톱 또는 모바일)이며 데스크톱이 기본값입니다.
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
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 |
보안문자 확인 결과
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
|
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 |
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
|
loadingExperience.overall_category |
string |
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
|
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 |
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
|
originLoadingExperience.overall_category |
string |
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
|
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 |
에뮬레이션에서 사용해야 하는 폼 팩터입니다.
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
|
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 |
열거된 점수 표시 모드입니다.
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
|
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 |
사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
|
|
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 |