Ngày xuất bản: 15 tháng 10 năm 2025
Kể từ hôm nay, chúng tôi sẽ phát hành phiên bản mới (V2) của Chrome Web Store API. API mới dễ sử dụng hơn đáng kể và hỗ trợ các tính năng như tài khoản dịch vụ, giúp bạn dễ dàng tích hợp với quy trình làm việc của doanh nghiệp. Chúng tôi cũng đã bổ sung thêm chức năng cho phép kiểm soát tỷ lệ triển khai và huỷ các bản gửi đang chờ xử lý theo cách lập trình.
Một API mới dựa trên ý kiến phản hồi của nhà phát triển
API mới được xây dựng dựa trên ý kiến phản hồi của nhà phát triển. Chúng tôi đã nỗ lực để các điểm cuối và phản hồi của API trở nên trực quan hơn.
Tính năng mới
Chúng tôi cũng đã thêm các tính năng mới mà trước đây không có trong API.
Truy cập vào trạng thái của mặt hàng đã xuất bản và mặt hàng nháp
Trước đây, bạn chỉ có thể truy xuất bản nháp gần đây nhất của một mục. Giờ đây, bạn có thể truy xuất cả bản sửa đổi đã xuất bản và bản sửa đổi đang chờ xử lý.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
Thao tác này sẽ trả về một phản hồi bao gồm những nội dung sau:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Huỷ yêu cầu gửi đang chờ xử lý
Giờ đây, bạn có thể huỷ một yêu cầu gửi đang chờ xử lý bằng API.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Sửa đổi tỷ lệ phát hành
Giờ đây, bạn có thể cập nhật tỷ lệ phát hành cho một tiện ích mà không cần gửi tiện ích đó đi xem xét. Điều này dựa trên ý kiến phản hồi của các nhà phát triển. Họ chỉ ra rằng trong phiên bản API trước, mọi nội dung cập nhật (kể cả nội dung cập nhật về tỷ lệ phần trăm mục tiêu) đều sẽ được coi là một nội dung mới được gửi và sẽ được xem xét riêng.
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
Hỗ trợ tài khoản dịch vụ
Giờ đây, bạn có thể cấp quyền truy cập cho tài khoản dịch vụ vào Chrome Web Store API. Bạn chỉ cần thêm các email bắt buộc trong Trang tổng quan dành cho nhà phát triển.
Chuẩn bị một mục để xuất bản
Trước đây, các bản sửa đổi được gửi bằng API luôn được xuất bản ngay sau khi vượt qua quy trình xem xét. Giờ đây, bạn có thể sử dụng trường publishType với STAGED_PUBLISH – khi mặt hàng của bạn vượt qua quy trình xem xét, mặt hàng đó sẽ được dàn xếp và có thể được xuất bản theo cách thủ công vào một thời điểm khác bằng cách sử dụng một lệnh gọi API khác hoặc theo cách thủ công bằng Trang tổng quan dành cho nhà phát triển.
Cải thiện công thái học
API Cửa hàng Chrome trực tuyến hiện xuất bản một tài liệu khám phá. Điều này cho phép bạn tương tác với API thông qua nhiều công cụ và thư viện của Google. Chúng tôi cũng xác định rõ hơn khái niệm về bản sửa đổi mặt hàng như một khái niệm cốt lõi trong API, giúp API dễ sử dụng hơn và mang lại nhiều sự linh hoạt hơn cho các phương thức bổ sung trong tương lai.
Tài liệu được cải thiện
Chúng tôi đã xuất bản tài liệu tham khảo API toàn diện hơn nhiều, sử dụng cùng một công cụ được dùng cho các API khác của Google. Trong đó có cả phần "Dùng thử!" Trình khám phá API cho phép bạn định cấu hình một yêu cầu bằng thông tin đăng nhập từ Tài khoản Google đã xác thực của bạn.
Nền tảng OAuth
Giờ đây, bạn có thể chọn phạm vi truy cập API Cửa hàng Chrome trực tuyến trong OAuth 2.0 playground. Thao tác này cho phép bạn lấy thông tin xác thực thử nghiệm và đưa ra các yêu cầu API thử nghiệm trong trình duyệt. Mặc dù công cụ này luôn hỗ trợ API Cửa hàng Chrome trực tuyến, nhưng các phạm vi và phương thức API không được đề xuất tự động.
Thư viện ứng dụng Google
Những nội dung cập nhật này cũng có nghĩa là API sẽ có trong các bản phát hành trong tương lai của Thư viện ứng dụng API của Google. Điều này sẽ giúp bạn dễ dàng gọi API bằng ngôn ngữ mà bạn chọn, bao gồm JavaScript, Node.js, Python và Java.
Cách di chuyển
Hầu hết các phương thức trong API V1 đều có phương thức tương đương trong API V2. Cập nhật mã để sử dụng các điểm cuối và định dạng yêu cầu mới, đồng thời xử lý các phản hồi đã cập nhật.
| Trường hợp sử dụng | Điểm cuối API cũ | Điểm cuối API mới |
|---|---|---|
| Nhận một mục | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| Cập nhật một mục | 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 |
| Xuất bản một mục | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
Bạn có thể tìm thấy các yêu cầu mẫu trong hướng dẫn Sử dụng Chrome Web Store API và tài liệu đầy đủ cho các phương thức mới tại đây.
API mới không hỗ trợ việc tạo các mục mới. Chức năng này ít khi được sử dụng và có ít tiện ích vì bạn vẫn phải cung cấp thêm siêu dữ liệu trong Trang tổng quan dành cho nhà phát triển.
Ngoài ra, chúng tôi không còn hỗ trợ việc thay đổi chế độ hiển thị của một mục bằng API nữa. Điều này nhằm đảm bảo rằng nhà phát triển xác nhận mọi thay đổi về chế độ hiển thị trong Trang tổng quan dành cho nhà phát triển.
Tiến trình di chuyển
Chúng tôi dự định hỗ trợ API cũ cho đến hết ngày 15 tháng 10 năm 2026. Sau thời điểm này, bạn sẽ cần chuyển sang API phiên bản 2 để tiếp tục đưa ra yêu cầu.
Tóm tắt
Chúng tôi rất vui mừng được chia sẻ những thay đổi này với bạn. Như thường lệ, nếu bạn có ý kiến phản hồi, vui lòng cho chúng tôi biết trong danh sách gửi thư chromium-extensions.