このページでは、VersionHistory ウェブサービス API に関する技術的なリファレンス情報を提供します。
すべての API アクセスは HTTPS 経由で、https://versionhistory.googleapis.com/v1 からアクセスされます。
バージョン
バージョンとは、ユーザーが実行している Chrome の特定のインスタンスのことです。
特定のプラットフォームとチャンネルのバージョン情報を取得する
指定したプラットフォームとチャネルのすべての Chrome バージョンを一覧表示します。
GET /{product}/platforms/{platform}/channels/{channel}/versions
| 名前 | 説明 |
|---|---|
product |
商品 ID。 |
platform |
プラットフォーム ID。 |
channel |
チャンネル ID。 |
リリース
リリースとは、ユーザーが特定のバージョンの Chrome を実行していた期間です。リリース エンドポイントには、その期間にそのバージョンの Chrome を実行していたユーザーの割合に関する情報も表示されます。
すべてのリリースを取得する
指定したプラットフォーム、チャンネル、バージョンのすべてのリリースを一覧表示します。
GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
| 名前 | 説明 |
|---|---|
product |
商品 ID。 |
platform |
プラットフォーム ID。 |
channel |
チャンネル ID。 |
version |
バージョン ID。 |
プロダクト
プロダクトとは、Chrome や Fuchsia Web Engine などのソフトウェアです。
商品 ID
| 説明 | 値 |
|---|---|
| Chrome | chrome |
| Fuchsia ウェブエンジン | fuchsiawebengine |
プラットフォーム
プラットフォームとは、プロダクトが動作するコンピューティング プラットフォームの 1 つです（Windows、Android など）。
すべてのプラットフォームを取得する
GET /{product}/platforms
| 名前 | 説明 |
|---|---|
product |
商品 ID。 |
すべてのプラットフォームとチャネルの組み合わせを取得する
GET /{product}/platforms/all/channels
| 名前 | 説明 |
|---|---|
product |
商品 ID。 |
プラットフォーム ID
| 説明 | 値 |
|---|---|
| すべてのプラットフォーム | 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 |
商品 ID。 |
platform |
プラットフォーム ID。 |
チャンネル識別子
VersionHistory API は、次のチャネル ID をサポートしています。
| 説明 | 値 |
|---|---|
| Extended Stable | extended |
| Stable | stable |
| Beta | beta |
| 開発 | dev |
| カナリア | canary |
| Canary（バリアント ビルド） | canary_asan |
結果をフィルタする
結果をフィルタするには、filter クエリ パラメータを追加します。フィルタリングをサポートしているのは、version エンドポイントと release エンドポイントのみです。例:
GET /chrome/platforms/win/channels/stable/versions/all/releases?filter=fraction=1
filter の値は、式のカンマ区切りのリストにする必要があります。各式は field operator value の形式にする必要があります。
| 項目 | 有効な値 |
|---|---|
| フィールド |
version、name、platform、starttime*、endtime*、fraction* |
| 演算子 |
<, <=, =,
>, >=
|
- チャンネルのフィルタリングは、Stable からの距離で行われ、
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は文字列比較によってフィルタされます。fractionは、ロールアウトに参加したユーザーの数を指定するために使用します。たとえば、fraction=1はユーザーの 100% を意味します。
結果の並べ替え
結果を並べ替えるには、order_by クエリ パラメータを追加します。並べ替えをサポートしているのは、version エンドポイントと release エンドポイントのみです。例:
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です。