このページには、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 Web Engine | fuchsiawebengine |
プラットフォーム
プラットフォームとは、プロダクトが稼働する 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 |
チャンネル
Chrome のチャンネルの説明については、使用するチャンネルを選択する方法をご覧ください。
プラットフォームの有効なチャンネルを取得する
特定のプラットフォームの有効なチャネルを一覧表示します。
GET /{product}/platforms/{platform}/channels
| 名前 | 説明 |
|---|---|
product |
商品 ID。 |
platform |
プラットフォーム ID。 |
チャンネル ID
VersionHistory API は、次のチャンネル ID をサポートしています。
| 説明 | 価値 |
|---|---|
| 拡張安定版 | 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 からの距離（
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の順になります。