Pagespeedapi: runpagespeed

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

요청

HTTP 요청

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

매개변수

매개변수 이름 설명
필수 쿼리 매개변수
url string 가져오고 분석할 URL입니다.
선택적 쿼리 매개변수
category string 실행할 Lighthouse 카테고리 카테고리를 지정하지 않으면 실적 카테고리만 실행됩니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "accessibility"
  • "best-practices"
  • "performance"
  • "pwa"
  • "seo"
locale string 형식이 지정된 결과를 현지화하는 데 사용되는 언어
strategy string 사용할 분석 전략 (데스크톱 또는 모바일)이며 데스크톱이 기본값입니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • '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 보안문자 확인 결과

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
loadingExperience.overall_category string

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "AVERAGE"
  • "FAST"
  • "NONE"
  • "SLOW"
originLoadingExperience.overall_category string

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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 에뮬레이션에서 사용해야 하는 폼 팩터입니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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 열거된 점수 표시 모드입니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.