发布时间：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 更易于使用，还为未来添加更多方法提供了更大的灵活性。
改进了文档
我们发布了更全面的 API 参考文档，并使用了与其他 Google API 相同的工具。这还包括“试试看！”API 浏览器，可让您使用经过身份验证的 Google 账号中的凭据配置单个请求。
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 中都有等效方法。更新您的代码，以使用新的端点和请求格式，并处理更新后的响应。
| 使用场景 | 旧 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 更改商品的公开范围。这是为了确保开发者在开发者信息中心内确认所有可见性变更。
迁移时间安排
我们计划在 2026 年 10 月 15 日之前继续支持旧版 API，届时您需要改用 V2 API 才能继续发出请求。
小结
我们很高兴能与您分享这些变化。与往常一样，如果您有任何反馈，请在 chromium-extensions 邮件列表中告知我们。