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