發布日期：2025 年 10 月 15 日
我們今天推出新版 (V2) 的 Chrome 線上應用程式商店 API。這個新版 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 更容易使用，並在未來為其他方法提供更多彈性。
改善說明文件
我們已發布更詳盡的 API 參考資料說明文件，並使用與其他 Google API 相同的工具。這也包括「試試看！」API 探索工具：可讓您使用已驗證 Google 帳戶的憑證，設定單一要求。
OAuth 遊樂場
您現在可以在 OAuth 2.0 Playground 中選取 Chrome 線上應用程式商店 API 範圍。您可以在瀏覽器中取得測試憑證，並發出測試 API 要求。這項工具一直以來都支援 Chrome 線上應用程式商店 API，但不會自動建議範圍和 API 方法。
Google 用戶端程式庫
這些更新也代表 API 將在日後發布的 Google API 用戶端程式庫中提供。這樣一來，您就能更輕鬆地使用自選語言 (包括 JavaScript、Node.js、Python 和 Java) 呼叫 API。
如何遷移
V1 API 中的大多數方法在 V2 API 中都有對應的方法。更新程式碼，使用新的端點和要求格式，並處理更新後的回應。
| 用途 | 舊版 API 端點 | 新的 API 端點 |
|---|---|---|
| 取得項目 | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| 更新項目 | PUT https://www.googleapis.com/upload/chromewebstore/v1.1/items/itemId |
POST https://chromewebstore.googleapis.com/upload/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:upload |
| 發布項目 | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
如需範例要求，請參閱「使用 Chrome 線上應用程式商店 API」教學課程，以及新方法的完整說明文件。
新版 API 不支援建立新項目。這項功能的使用率偏低，而且由於仍須在開發人員資訊主頁中提供其他中繼資料，因此實用性有限。
此外，我們不再支援使用 API 變更項目的瀏覽權限。這是為了確保開發人員在開發人員資訊主頁中確認任何顯示設定變更。
遷移時程
我們預計支援舊版 API 至 2026 年 10 月 15 日，屆時您必須改用第 2 版 API，才能繼續提出要求。
總結
我們很期待與您分享這些變更。如有任何意見回饋，歡迎透過 chromium-extensions 郵寄清單與我們聯絡。