Dipublikasikan: 15 Oktober 2025
Mulai hari ini, kami merilis versi baru (V2) Chrome Web Store API. API baru ini jauh lebih mudah digunakan, dan memiliki dukungan untuk fitur seperti akun layanan, sehingga memudahkan integrasi dengan alur kerja perusahaan. Kami juga telah menambahkan lebih banyak fungsi dengan kemampuan untuk mengontrol peluncuran persentase dan membatalkan pengiriman yang tertunda secara terprogram.
API baru berdasarkan masukan developer
API baru ini dibuat dengan mempertimbangkan masukan developer. Kami telah berupaya membuat endpoint dan respons API menjadi lebih intuitif.
Fitur baru
Kami juga telah menambahkan fitur baru yang sebelumnya tidak tersedia di API.
Mengakses status item yang dipublikasikan dan draf
Sebelumnya, Anda hanya dapat mengambil revisi draf terbaru untuk suatu item. Sekarang Anda dapat mengambil revisi yang dipublikasikan dan yang tertunda.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
Tindakan ini akan menampilkan respons yang mencakup hal berikut:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
Membatalkan pengiriman yang tertunda
Anda kini dapat membatalkan pengiriman yang tertunda menggunakan API.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
Mengubah peluncuran persentase
Sekarang Anda dapat memperbarui peluncuran persentase untuk ekstensi tanpa mengirimkannya untuk ditinjau. Hal ini didasarkan pada masukan dari developer, yang menunjukkan bahwa pada versi API sebelumnya, setiap pembaruan, termasuk persentase target, akan diperlakukan sebagai pengiriman baru yang akan ditinjau secara terpisah.
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
Dukungan akun layanan
Sekarang Anda dapat memberi akun layanan akses ke Chrome Web Store API. Cukup tambahkan email yang diperlukan di Dasbor Developer.
Menyiapkan item untuk dipublikasikan
Sebelumnya, revisi yang dikirimkan menggunakan API selalu dipublikasikan segera setelah lulus peninjauan. Sekarang, Anda dapat menggunakan kolom publishType dengan STAGED_PUBLISH-saat item Anda lulus peninjauan, item tersebut akan dipentaskan dan dapat dipublikasikan secara manual di lain waktu menggunakan panggilan API lain atau secara manual menggunakan Dasbor Developer.
Ergonomi yang ditingkatkan
Chrome Web Store API kini memublikasikan dokumen penemuan. Dengan begitu, Anda dapat berinteraksi dengan API melalui berbagai alat dan library Google. Kami juga telah mendefinisikan konsep revisi item dengan lebih jelas sebagai konsep inti dalam API, yang membuat API lebih mudah digunakan dan memberikan fleksibilitas yang lebih besar untuk metode tambahan di masa mendatang.
Peningkatan dokumentasi
Kami telah memublikasikan dokumentasi referensi API yang jauh lebih ekstensif, menggunakan alat yang sama dengan yang digunakan untuk Google API lainnya. Hal ini juga mencakup "Coba". Penjelajah API yang memungkinkan Anda mengonfigurasi satu permintaan menggunakan kredensial dari Akun Google Anda yang diautentikasi.
OAuth playground
Sekarang Anda dapat memilih cakupan Chrome Web Store API di OAuth 2.0 playground. Dengan begitu, Anda dapat memperoleh kredensial pengujian dan membuat permintaan API pengujian di browser. Meskipun alat ini selalu mendukung API Chrome Web Store, cakupan dan metode API tidak disarankan secara otomatis.
Library klien Google
Pembaruan ini juga berarti API akan tersedia di rilis mendatang library klien Google API. Hal ini akan memudahkan pemanggilan API dari bahasa pilihan Anda, termasuk JavaScript, Node.js, Python, dan Java.
Cara melakukan migrasi
Sebagian besar metode di V1 API memiliki metode yang setara di V2 API. Perbarui kode Anda untuk menggunakan format permintaan dan endpoint baru, serta untuk menangani respons yang diperbarui.
| Kasus penggunaan | Endpoint API lama | Endpoint API baru |
|---|---|---|
| Mendapatkan item | GET https://www.googleapis.com/chromewebstore/v1.1/items/itemId |
GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus |
| Memperbarui item | 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 |
| Memublikasikan item | POST https://www.googleapis.com/chromewebstore/v1.1/items/itemId/publish |
POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:publish |
Anda dapat menemukan contoh permintaan dalam tutorial Menggunakan Chrome Web Store API dan dokumentasi lengkap untuk metode baru di sini.
API baru tidak mendukung pembuatan item baru. Fungsi ini jarang digunakan, dan memiliki kegunaan terbatas karena metadata tambahan masih harus diberikan di Dasbor Developer.
Selain itu, kami tidak lagi mendukung perubahan visibilitas item menggunakan API. Hal ini dilakukan untuk memastikan bahwa setiap perubahan visibilitas dikonfirmasi oleh developer di Dasbor Developer.
Timeline migrasi
Kami berencana mendukung API lama hingga 15 Oktober 2026. Setelah itu, Anda harus beralih ke API V2 untuk terus membuat permintaan.
Rangkuman
Kami sangat senang untuk menyampaikan perubahan ini kepada Anda. Seperti biasa, jika ada masukan, harap beri tahu kami di milis chromium-extensions.