VersionHistory API リファレンス

このページでは、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 ウェブエンジンなどのソフトウェアです。

商品 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（バリアント ビルド） 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 は文字列比較によってフィルタされます。
  • Chrome で引き続き配信されているリリースの場合、serving.endtime は入力されません。並べ替えまたはフィルタリング中に、フィールドに値が入力されていない場合、serving.endtime は 1970-01-01T00:00:00Z として扱われます。
  • 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 です。