이 페이지에는 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 Web Engine과 같은 소프트웨어입니다.
제품 식별자
설명 | 값 |
---|---|
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
값의 쉼표로 구분된 목록을 허용합니다.
오름차순 또는 내림차순을 지정하려면 공백 문자 (%20
)와 order_by
값 뒤에 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
입니다.