新しい Chrome ウェブストア API のご紹介

Oliver Dunk

公開日: 2025 年 10 月 15 日

本日より、Chrome ウェブストア API の新バージョン（V2）をリリースします。新しい API は大幅に使いやすくなり、サービス アカウントなどの機能もサポートされているため、エンタープライズ ワークフローとの統合が容易になります。また、ロールアウトの割合を制御したり、保留中の送信をプログラムでキャンセルしたりできる機能も追加しました。

デベロッパーのフィードバックに基づく新しい API

新しい API は、デベロッパーのフィードバックを念頭に置いて構築されました。API エンドポイントとレスポンスをより直感的に使用できるようにしました。

新機能

また、以前は API で利用できなかった新機能も追加しました。

公開済みアイテムと下書きアイテムのステータスにアクセスする

以前は、アイテムの最新のドラフト リビジョンのみを取得できました。これで、公開済みのリビジョンと保留中のリビジョンの両方を取得できるようになりました。

curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus

これにより、次のようなレスポンスが返されます。

{
  ...,
  "publishedItemRevisionStatus": { ... },
  "submittedItemRevisionStatus": { ... },
  ...
}

保留中の送信をキャンセルする

API を使用して、保留中の送信をキャンセルできるようになりました。

curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission

割合ロールアウトを変更する

拡張機能のロールアウトの割合を、審査に送信せずに更新できるようになりました。これは、以前の API バージョンでは、目標割合の更新を含むすべての更新が新しい送信として扱われ、個別に審査を受けることになると指摘したデベロッパーからのフィードバックに基づいています。

curl -H "Authorization: Bearer $TOKEN" -X POST -H "Content-Type: application/json" -d "{ "deployPercentage": 100 }" https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:setPublishedDeployPercentage

サービス アカウントのサポート

Chrome ウェブストア API へのサービス アカウントのアクセス権を付与できるようになりました。デベロッパー ダッシュボードで必要なメールアドレスを追加するだけです。

公開するアイテムをステージングする

以前は、API を使用して送信された改訂版は、審査に合格するとすぐに公開されていました。publishType フィールドを STAGED_PUBLISH とともに使用できるようになりました。アイテムが審査に合格すると、ステージングされ、別の API 呼び出しを使用するか、デベロッパー ダッシュボードを使用して手動で後から公開できます。

人間工学の改善

Chrome ウェブストア API でディスカバリ ドキュメントが公開されるようになりました。これにより、さまざまな Google ツールとライブラリを介して API を操作できます。また、API のコアコンセプトとしてアイテム リビジョンのコンセプトをより明確に定義しました。これにより、API の使いやすさが向上し、将来的に追加されるメソッドの柔軟性が高まります。

マニュアルの強化

他の Google API で使用されているものと同じツールを使用して、より広範な API リファレンス ドキュメントを公開しました。「試してみる」ボタンも含まれます。認証済みの Google アカウントの認証情報を使用して単一のリクエストを構成できる API エクスプローラ。

OAuth Playground

OAuth 2.0 Playground で Chrome ウェブストア API のスコープを選択できるようになりました。これにより、テスト認証情報を取得して、ブラウザでテスト API リクエストを行うことができます。このツールはこれまでも Chrome ウェブストア API をサポートしていましたが、スコープと API メソッドは自動的に提案されませんでした。

Google クライアント ライブラリ

これらの更新により、API は Google API クライアント ライブラリの今後のリリースでも利用できるようになります。これにより、JavaScript、Node.js、Python、Java などの選択した言語から API を簡単に呼び出すことができます。

移行方法

V1 API のほとんどのメソッドには、V2 API に同等のメソッドがあります。新しいエンドポイントとリクエスト形式を使用し、更新されたレスポンスを処理するようにコードを更新します。

リクエストの例については、Chrome ウェブストア API の使用チュートリアルと、新しいメソッドの完全なドキュメントをご覧ください。

新しい API では、新しいアイテムの作成はサポートされていません。この機能は使用される頻度が低く、追加のメタデータはデベロッパー ダッシュボードで提供する必要があったため、有用性も限られていました。

また、API を使用してアイテムの公開設定を変更することもできなくなりました。これは、公開設定の変更がデベロッパー ダッシュボードでデベロッパーによって確認されるようにするためです。

移行スケジュール

古い API は 2026 年 10 月 15 日までサポートする予定です。それ以降もリクエストを継続するには、V2 API に移行する必要があります。

まとめ

これらの変更を皆様にお知らせできることを、大変嬉しく思います。フィードバックがありましたら、chromium-extensions メーリング リストでお知らせください。