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 チャンネル識別子。

リリース

リリースとは、ユーザーが特定のバージョンの Chrome を実行していた期間です。リリース エンドポイントでは、期間中にそのバージョンの Chrome を実行したユーザーの割合に関する情報も提供されます。

すべてのリリースを入手する

指定したプラットフォーム、チャネル、バージョンのすべてのリリースを一覧表示します。

GET /{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases
名前 説明
product 商品 ID。
platform プラットフォーム ID。
channel チャンネル識別子。
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
ウィンドウ 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 extended
安定的 stable
ベータ版 beta
開発 dev
Canary 版 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 の順です。