이 페이지에는 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입니다.