Method: pagespeedapi.runpagespeed

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

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
category

enum (Category)

실행할 Lighthouse 카테고리입니다. 아무것도 지정하지 않으면 성능 카테고리만 실행됩니다.
locale

string

형식이 지정된 결과를 현지화하는 데 사용되는 언어입니다.
strategy

enum (Strategy)

사용할 분석 전략 (데스크톱 또는 모바일)이며 데스크톱이 기본값입니다.
url

string

필수 항목입니다. 가져오고 분석할 URL입니다.
utm_campaign

string

분석을 위한 캠페인 이름입니다.
utm_source

string

분석을 위한 캠페인 소스
captchaToken

string

보안문자를 입력할 때 전달된 보안문자 토큰입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

Pagespeed API 응답 객체입니다.

JSON 표현 
{
  "kind": string,
  "captchaResult": string,
  "id": string,
  "loadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "originLoadingExperience": {
    object (PagespeedApiLoadingExperienceV5)
  },
  "analysisUTCTimestamp": string,
  "lighthouseResult": {
    object (LighthouseResultV5)
  },
  "version": {
    object (PagespeedVersion)
  }
}
입력란
kind

string

결과의 유형입니다.
captchaResult

string

보안문자 확인 결과
id

string

다음 페이지 리디렉션 후 문서의 표준화된 최종 도착 URL입니다 (있는 경우).
loadingExperience

object (PagespeedApiLoadingExperienceV5)

최종 사용자의 페이지 로드 경험에 대한 측정항목입니다.
originLoadingExperience

object (PagespeedApiLoadingExperienceV5)

원본에서 집계된 페이지 로드 환경의 측정항목
analysisUTCTimestamp

string

이 분석의 UTC 타임스탬프입니다.
lighthouseResult

object (LighthouseResultV5)

객체로서의 감사 URL에 대한 Lighthouse 응답입니다.
version

object (PagespeedVersion)

이 결과를 생성하는 데 사용된 PageSpeed의 버전입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • openid

자세한 내용은 OAuth 2.0 개요를 참고하세요.

카테고리

분석해야 하는 열거된 카테고리입니다.

열거형
CATEGORY_UNSPECIFIED 기본 UNDEFINED 카테고리입니다.
ACCESSIBILITY 접근성 (a11y), 모든 사용자가 액세스할 수 있는 웹사이트 기능과 관련된 카테고리입니다.
BEST_PRACTICES 권장사항, 웹사이트의 웹 권장사항 준수와 관련된 카테고리입니다.
PERFORMANCE 실적, 웹사이트 실적과 관련된 카테고리입니다.
SEO 검색엔진 최적화 (SEO), 검색엔진이 웹사이트의 색인을 생성하는 기능과 관련된 카테고리입니다.

전략

분석에 사용할 기기 실행 전략입니다.

열거형
STRATEGY_UNSPECIFIED 정의되지 않음.
DESKTOP 데스크톱 브라우저의 URL을 가져와 분석합니다.
MOBILE 휴대기기용 URL을 가져와 분석합니다.

PagespeedApiLoadingExperienceV5

CrUX 데이터 분류가 포함된 CrUX 로드 환경 객체입니다.

JSON 표현 
{
  "id": string,
  "metrics": {
    string: {
      object (UserPageLoadMetricV5)
    },
    ...
  },
  "overall_category": string,
  "initial_url": string,
  "origin_fallback": boolean
}
입력란
id

string

측정항목이 있는 URL, 패턴 또는 출처입니다.
metrics

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

<metrics, data>의 맵입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
overall_category

string

사람이 읽을 수 있는 ID의 속도 '카테고리'입니다.
initial_url

string

요청된 URL로, 확인된 'ID'와 다를 수 있습니다.
origin_fallback

boolean

결과가 페이지의 출처 대체인 경우 true, 그렇지 않은 경우 false입니다.

LighthouseResultV5

Lighthouse 결과 객체입니다.

JSON 표현 
{
  "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)
  }
}
입력란
fetchTime

string

이 실행을 가져온 시간입니다.
requestedUrl

string

요청한 원래 URL입니다.
finalUrl

string

감사를 거친 최종 확인된 URL입니다.
lighthouseVersion

string

이 LHR을 생성하는 데 사용된 Lighthouse 버전입니다.
i18n

object (I18n)

LHR을 렌더링하는 데 필요한 국제화 문자열입니다.
userAgent

string

이 LHR을 실행하는 데 사용된 사용자 에이전트입니다.
audits

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

LHR 감사 지도

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
categoryGroups

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

LHR의 카테고리 그룹 맵입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
stackPacks[]

object (StackPack)

Stack Pack 조언 문자열입니다.
environment

object (Environment)

이 LHR을 만들 때 사용된 환경 설정입니다.
runWarnings

array (ListValue format)

LHR의 모든 실행 경고 목록입니다. 항상 [] 이상으로 출력됩니다.
runtimeError

object (RuntimeError)

최상위 오류 메시지인 경우 이 Lighthouse 결과를 삭제해야 할 만큼 심각한 문제를 나타냅니다.
categories

object (Categories)

LHR의 카테고리 맵입니다.
timing

object (Timing)

이 LHR의 타이밍 정보입니다.
configSettings

object (ConfigSettings)

이 LHR의 구성 설정입니다.

국제화

LHR - 버전 1의 i18n 데이터가 포함된 메시지입니다.

JSON 표현 
{
  "rendererFormattedStrings": {
    object (RendererFormattedStrings)
  }
}
입력란
rendererFormattedStrings

object (RendererFormattedStrings)

configSettings에서 언어에 맞게 형식이 지정되는 국제화된 문자열입니다.

RendererFormattedStrings

렌더기에 사용되는 형식이 지정된 문자열을 포함하는 메시지입니다.

JSON 표현 
{
  "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
}
입력란
varianceDisclaimer

string

실적 측정항목 값 아래에 표시된 면책조항입니다.
opportunityResourceColumnLabel

string

감사의 페이지 로드 예상 절감 기회의 제목입니다.
opportunitySavingsColumnLabel

string

기회 감사로 인한 페이지 로드 예상 절감량의 제목입니다.
errorMissingAuditInfo

string

오류가 발생한 감사 옆에 표시되는 오류 문자열입니다.
errorLabel

string

오류가 발생한 감사 또는 측정항목 옆에 표시되는 라벨입니다.
warningHeader

string

글머리기호 목록 위에 표시되는 라벨입니다.
auditGroupExpandTooltip

string

펼칠 수 있는 V형 아이콘의 도움말 텍스트입니다.
passedAuditsGroupTitle

string

통과한 감사 목록 위에 표시되는 제목입니다.
notApplicableAuditsGroupTitle

string

페이지에 적용되지 않는 감사 목록 위에 표시된 제목.
manualAuditsGroupTitle

string

실행 시 전산되지 않은 감사 목록 위에 표시된 제목입니다.
toplevelWarningsMessage

string

전체 보고서가 무효화되었을 수 있는 중요한 경고 앞에 표시된 라벨입니다.
scorescaleLabel

string

점수 척도 (0~49, 50~89, 90~100)를 설명하는 라벨입니다.
crcLongestDurationLabel

string

중요한 요청 체인의 요약에 표시되는 값의 라벨입니다.
crcInitialNavigation

string

중요한 요청 체인의 초기 요청 라벨입니다.
lsPerformanceCategoryDescription

string

실적 아래에 표시되는 면책 조항에는 네트워크가 다를 수 있다는 설명.
labDataTitle

string

실습 데이터 성능 카테고리의 제목입니다.

StackPack

스택 팩 정보가 포함된 메시지입니다.

JSON 표현 
{
  "id": string,
  "title": string,
  "iconDataURL": string,
  "descriptions": {
    string: string,
    ...
  }
}
입력란
id

string

스택 팩 ID
title

string

스택 팩 제목
iconDataURL

string

스택 팩 아이콘 데이터 URI
descriptions

map (key: string, value: string)

스택 팩 조언 문자열입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

환경

Lighthouse 실행을 위한 환경 구성이 포함된 메시지입니다.

JSON 표현 
{
  "networkUserAgent": string,
  "hostUserAgent": string,
  "benchmarkIndex": number
}
입력란
networkUserAgent

string

네트워크를 통해 전송된 사용자 에이전트 문자열입니다.
hostUserAgent

string

사용된 Chrome 버전의 사용자 에이전트 문자열입니다.
benchmarkIndex

number

대략적인 기기 클래스를 나타내는 벤치마크 색인 번호입니다.

RuntimeError

런타임 오류 구성이 포함된 메시지입니다.

JSON 표현 
{
  "code": string,
  "message": string
}
입력란
code

string

열거형 Lighthouse 오류 코드입니다.
message

string

사람이 읽을 수 있는 오류 코드를 설명하는 메시지입니다.

카테고리

Lighthouse의 카테고리가 실행됩니다.

JSON 표현 
{
  "accessibility": {
    object (LighthouseCategoryV5)
  },
  "best-practices": {
    object (LighthouseCategoryV5)
  },
  "seo": {
    object (LighthouseCategoryV5)
  },
  },
  "performance": {
    object (LighthouseCategoryV5)
  }
}
입력란
accessibility

object (LighthouseCategoryV5)

모든 접근성 관련 감사가 포함된 접근성 카테고리입니다.
best-practices

object (LighthouseCategoryV5)

모든 권장사항 관련 감사가 포함된 권장사항 카테고리입니다.
seo

object (LighthouseCategoryV5)

모든 검색엔진 최적화 관련 감사가 포함된 검색 엔진 최적화 (SEO) 카테고리
performance

object (LighthouseCategoryV5)

모든 성능 관련 감사가 포함된 성능 카테고리입니다.

LighthouseCategoryV5

Lighthouse 카테고리입니다.

JSON 표현 
{
  "id": string,
  "title": string,
  "description": string,
  "manualDescription": string,
  "auditRefs": [
    {
      object (AuditRefs)
    }
  ],
  "score": value
}
입력란
id

string

카테고리의 문자열 식별자입니다.
title

string

사람이 읽을 수 있는 카테고리 이름입니다.
description

string

카테고리 및 중요도에 관한 자세한 설명
manualDescription

string

카테고리의 수동 감사에 대한 설명입니다.
auditRefs[]

object (AuditRefs)

이 카테고리의 모든 감사 구성원에 대한 참조의 배열입니다.
score

value (Value format)

카테고리의 전체 점수로, 모든 감사에서 가중치가 적용된 평균입니다. (카테고리의 점수는 null일 수 있습니다.)

AuditRefs

ID별 감사에 대한 간단한 참조로, 특정 카테고리에서 감사를 그룹화하고 가중치를 적용하는 데 사용됩니다.

JSON 표현 
{
  "id": string,
  "weight": number,
  "group": string
}
입력란
id

string

감사 참조 ID입니다.
weight

number

전체 카테고리 점수에서 이 감사 점수가 차지하는 가중치입니다.
group

string

감사가 속한 카테고리 그룹입니다 (선택사항).

시간

Lighthouse 실행의 성능 타이밍 데이터가 포함된 메시지입니다.

JSON 표현 
{
  "total": number
}
입력란
total

number

Lighthouse가 실행된 총시간입니다.

ConfigSettings

Lighthouse 실행의 구성 설정이 포함된 메시지입니다.

JSON 표현 
{
  "onlyCategories": value,
  "emulatedFormFactor": string,
  "locale": string,
  "channel": string,
  "formFactor": string
}
입력란
onlyCategories

value (Value format)

실행 시 수행해야 하는 감사 카테고리 목록입니다.
emulatedFormFactor
(deprecated)

string

에뮬레이션이 사용해야 하는 폼 팩터입니다. 이 필드는 지원 중단되었습니다. 대신 formFactor를 사용해야 합니다.
locale

string

언어 설정입니다.
channel

string

Lighthouse가 실행된 방식(예: Chrome 확장 프로그램 또는 npm 모듈)
formFactor

string

Lighthouse에서 점수 성능 측정항목 및 데스크톱의 모바일 전용 테스트 건너뛰기와 관련하여 이 실행을 어떻게 해석해야 할까요?

PagespeedVersion

Pagespeed 버전 객체입니다.

JSON 표현 
{
  "major": string,
  "minor": string
}
입력란
major

string

이 결과를 생성하는 데 사용된 PageSpeed의 주 버전 번호입니다.
minor

string

이 결과를 생성하는 데 사용된 PageSpeed의 부 버전 번호입니다.