VersionHistory API 참조

이 페이지에는 VersionHistory 웹 서비스 API에 관한 기술 참조 정보가 포함되어 있습니다.

모든 API 액세스는 HTTPS를 통해 이루어지며 https://versionhistory.googleapis.com/v1에서 액세스합니다.

버전

버전은 사용자가 실행 중인 Chrome의 특정 인스턴스입니다.

특정 플랫폼 및 채널의 버전 정보 가져오기

지정된 플랫폼 및 채널의 모든 Chrome 버전을 나열합니다.

GET /{product}/platforms/{platform}/channels/{channel}/versions
이름 설명
product 제품 식별자입니다.
platform 플랫폼 식별자입니다.
channel 채널 식별자입니다.

출시

출시는 사용자가 특정 버전의 Chrome을 실행한 간격입니다. 출시 엔드포인트는 해당 기간 동안 해당 버전의 Chrome을 실행한 사용자의 비율에 관한 정보도 제공합니다.

모든 발표곡 가져오기

지정된 플랫폼, 채널, 버전의 모든 발표곡을 나열합니다.

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
이름 설명
product 제품 식별자입니다.
platform 플랫폼 식별자입니다.
channel 채널 식별자입니다.
version 버전 식별자입니다.

제품

제품은 Chrome 또는 Fuchsia 웹 엔진과 같은 소프트웨어입니다.

제품 식별자

설명 값
Chrome chrome
Fuchsia 웹 엔진 fuchsiawebengine

플랫폼

플랫폼은 제품이 실행되는 컴퓨팅 플랫폼(예: Windows, Android) 중 하나입니다.

모든 플랫폼 가져오기

GET /{product}/platforms
이름 설명
product 제품 식별자입니다.

모든 플랫폼 및 채널 조합 가져오기

GET /{product}/platforms/all/channels
이름 설명
product 제품 식별자입니다.

플랫폼 식별자

설명 값
모든 플랫폼 all
Windows win
Windows (64비트) win64
Mac mac
Mac (ARM64) mac_arm64
Linux linux
Android android
WebView webview
iOS ios
Lacros lacros

채널

Chrome 채널에 관한 설명은 사용할 채널을 선택하려면 어떻게 해야 하나요?를 참고하세요.

플랫폼의 유효한 채널 가져오기

지정된 플랫폼에 유효한 채널을 나열합니다.

GET /{product}/platforms/{platform}/channels
이름 설명
product 제품 식별자입니다.
platform 플랫폼 식별자입니다.

채널 식별자

VersionHistory API는 다음 채널 식별자를 지원합니다.

설명 값
확장된 안정화 버전 extended
정식 stable
베타 beta
개발 dev
카나리아 canary
카나리아 (대안 빌드) canary_asan

검색 결과 필터링

filter 쿼리 매개변수를 추가하여 결과를 필터링합니다. 버전 및 출시 엔드포인트만 필터링을 지원합니다. 예:

GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1

filter 값은 쉼표로 구분된 표현식 목록이어야 합니다. 각 표현식은 field operator value 형식이어야 합니다.

항목 유효한 값
필드 version, name, platform, starttime*, endtime*, fraction*
연산자 <, <=, =, >, >=
  • 채널 필터링은 안정화 버전과의 거리에 따라 이루어집니다. 즉, stable < beta < dev < canary < canary_asan입니다. 예를 들어 channel<=dev는 stable, beta, dev의 정보를 반환합니다.
  • 버전 필터링은 숫자로 이루어집니다(예: 1.0.0.8 < 1.0.0.10). 버전이 완전히 작성되지 않은 경우 VersionHistory는 누락된 필드에 0를 추가합니다. 예를 들어 version>80는 version>80.0.0.0가 됩니다.
  • endtime=none: 현재 게시 중이며 아직 종료 시간이 없는 발표 트랙을 필터링합니다.
  • starttime 또는 endtime로 필터링할 때 값은 RFC 3339 날짜 문자열 형식이어야 합니다.
  • name 및 platform는 문자열 비교를 통해 필터링됩니다.
  • Chrome에서 아직 게재 중인 출시의 경우 serving.endtime가 채워지지 않습니다. 정렬 또는 필터링 중에 필드가 채워지지 않으면 serving.endtime이 1970-01-01T00:00:00Z로 취급됩니다.
  • fraction는 출시에 참여한 사용자 수를 지정하는 데 사용됩니다. 예를 들어 fraction=1은 사용자의 100% 를 의미합니다.

결과 정렬

결과를 정렬하려면 order_by 쿼리 매개변수를 추가합니다. 버전 및 출시 엔드포인트만 순서 지정을 지원합니다. 예:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime

order_by는 version, name, platform, channel, starttime, endtime, fraction 값의 쉼표로 구분된 목록을 허용합니다.

order_by 값 뒤에 공백 문자 (%20)와 asc 또는 desc를 추가하여 오름차순 또는 내림차순 정렬을 지정합니다. 예:

GET /chrome/platforms/win/channels/stable/versions/all/releases?order_by=starttime%20asc
  • 채널 순서는 stable, beta, dev, canary, canary_asan 순으로 지정됩니다.
  • name순서는 단순한 문자열 정렬이므로 예기치 않은 동작이 발생할 수 있습니다. 예를 들어 1.0.0.8은 1.0.0.10보다 낮은 버전입니다.
  • order_by를 지정하지 않으면 기본 순서는 platform, channel, version, serving.starttime 순입니다.