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

채널

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

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

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

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

채널 식별자

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

설명 가치
확장 안정화 버전 extended
정식 stable
베타 beta
개발 dev
카나리아 canary
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입니다.