पब्लिश होने की तारीख: 15 अक्टूबर, 2025
आज से, हम Chrome Web Store API का नया वर्शन (V2) रिलीज़ कर रहे हैं. नया एपीआई इस्तेमाल करने में काफ़ी आसान है. साथ ही, इसमें सेवा खातों जैसी सुविधाओं के लिए सहायता उपलब्ध है. इससे, इसे एंटरप्राइज़ वर्कफ़्लो के साथ इंटिग्रेट करना आसान हो जाता है. हमने इसमें कुछ और सुविधाएं भी जोड़ी हैं. जैसे, रोलआउट के प्रतिशत को कंट्रोल करने की सुविधा और प्रोग्राम के हिसाब से, सबमिट किए गए ऐसे अनुरोधों को रद्द करने की सुविधा जिन्हें मंज़ूरी नहीं मिली है.
डेवलपर के सुझाव के आधार पर बनाया गया नया एपीआई
नए एपीआई को डेवलपर के सुझाव/राय को ध्यान में रखकर बनाया गया है. हमने एपीआई एंडपॉइंट और जवाबों को ज़्यादा बेहतर बनाने के लिए काम किया है.
नई सुविधाएं
हमने नई सुविधाएं भी जोड़ी हैं, जो पहले एपीआई में उपलब्ध नहीं थीं.
पब्लिश किए गए और ड्राफ़्ट आइटम की स्थिति को ऐक्सेस करना
पहले, किसी आइटम के लिए सिर्फ़ सबसे हाल ही के ड्राफ़्ट वर्शन को वापस लाया जा सकता था. अब पब्लिश किए गए और समीक्षा के लिए सबमिट किए गए वर्शन, दोनों को वापस लाया जा सकता है.
curl -H "Authorization: Bearer $TOKEN" -X GET https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:fetchStatus
इससे आपको ऐसा जवाब मिलेगा जिसमें ये चीज़ें शामिल होंगी:
{
...,
"publishedItemRevisionStatus": { ... },
"submittedItemRevisionStatus": { ... },
...
}
लंबित सबमिशन रद्द करना
अब एपीआई का इस्तेमाल करके, सबमिट किए गए ऐसे अनुरोध को रद्द किया जा सकता है जिसे मंज़ूरी मिलना बाकी है.
curl -H "Authorization: Bearer $TOKEN" -X POST https://chromewebstore.googleapis.com/v2/publishers/PUBLISHER_ID/items/EXTENSION_ID:cancelSubmission
लॉन्च के प्रतिशत में बदलाव करना
अब एक्सटेंशन को समीक्षा के लिए सबमिट किए बिना, उसके रोलआउट का प्रतिशत अपडेट किया जा सकता है. यह बदलाव, डेवलपर से मिले सुझावों के आधार पर किया गया है. डेवलपर ने बताया था कि एपीआई के पिछले वर्शन में, टारगेट प्रतिशत में किए गए किसी भी अपडेट को एक नया सबमिशन माना जाता था. इसकी अलग से समीक्षा की जाती थी.
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 Web Store API का ऐक्सेस, सेवा खातों को दिया जा सकता है. बस Developer Dashboard में जाकर, ज़रूरी ईमेल पते जोड़ें.
किसी आइटम को पब्लिश करने के लिए स्टेज करना
पहले, एपीआई का इस्तेमाल करके सबमिट किए गए बदलावों को समीक्षा के बाद तुरंत पब्लिश कर दिया जाता था. अब STAGED_PUBLISH के साथ publishType फ़ील्ड का इस्तेमाल किया जा सकता है. इससे समीक्षा पास करने के बाद, आपका आइटम स्टेज हो जाएगा. साथ ही, इसे बाद में किसी अन्य एपीआई कॉल का इस्तेमाल करके या डेवलपर डैशबोर्ड में जाकर मैन्युअल तरीके से पब्लिश किया जा सकेगा.
बेहतर एर्गोनॉमिक्स
Chrome Web Store API अब डिस्कवरी दस्तावेज़ पब्लिश करता है. इससे, Google के अलग-अलग टूल और लाइब्रेरी की मदद से एपीआई का इस्तेमाल किया जा सकता है. हमने एपीआई में आइटम के वर्शन के कॉन्सेप्ट को भी ज़्यादा साफ़ तौर पर बताया है. इससे एपीआई का इस्तेमाल करना आसान हो जाता है. साथ ही, आने वाले समय में अन्य तरीकों को इस्तेमाल करने की सुविधा भी मिलती है.
बेहतर दस्तावेज़
हमने एपीआई के रेफ़रंस से जुड़ा ज़्यादा जानकारी वाला दस्तावेज़ पब्लिश किया है. इसके लिए, हमने उसी टूल का इस्तेमाल किया है जिसका इस्तेमाल Google के अन्य एपीआई के लिए किया जाता है. इसमें "इसे आज़माएं!" भी शामिल है एपीआई एक्सप्लोरर, जिसकी मदद से पुष्टि किए गए Google खाते के क्रेडेंशियल का इस्तेमाल करके, एक ही अनुरोध को कॉन्फ़िगर किया जा सकता है.
OAuth प्लेग्राउंड
अब OAuth 2.0 playground में, Chrome Web Store API का स्कोप चुना जा सकता है. इससे आपको ब्राउज़र में टेस्ट क्रेडेंशियल पाने और टेस्ट एपीआई अनुरोध करने की सुविधा मिलती है. यह टूल हमेशा से Chrome Web Store API के साथ काम करता है. हालांकि, स्कोप और एपीआई के तरीके अपने-आप नहीं सुझाए जाते थे.
Google क्लाइंट लाइब्रेरी
इन अपडेट का मतलब यह भी है कि एपीआई, Google API क्लाइंट लाइब्रेरी के आने वाले वर्शन में उपलब्ध होगा. इससे, अपनी पसंद की भाषा में एपीआई को कॉल करना आसान हो जाएगा. जैसे, JavaScript, Node.js, Python, और Java.
माइग्रेट करने का तरीका
V1 API के ज़्यादातर तरीकों के लिए, V2 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 Web Store API का इस्तेमाल करना ट्यूटोरियल में अनुरोध के उदाहरण मिल सकते हैं. साथ ही, यहां नए तरीकों के बारे में पूरी जानकारी दी गई है.
नए एपीआई में, नए आइटम बनाने की सुविधा नहीं है. इस सुविधा का इस्तेमाल बहुत कम किया जाता था. साथ ही, इसकी उपयोगिता सीमित थी, क्योंकि डेवलपर डैशबोर्ड में अब भी अतिरिक्त मेटाडेटा देना पड़ता था.
इसके अलावा, अब हम एपीआई का इस्तेमाल करके किसी आइटम के दिखने की सेटिंग में बदलाव करने की सुविधा नहीं देते हैं. इससे यह पक्का किया जाता है कि डेवलपर डैशबोर्ड में, डेवलपर ने दिखने की सेटिंग में किए गए बदलावों की पुष्टि कर दी है.
मेटाडेटा दूसरी जगह भेजने की समयावधि
हम पुराने एपीआई को 15 अक्टूबर, 2026 तक सपोर्ट करेंगे. इसके बाद, आपको अनुरोध जारी रखने के लिए V2 API पर माइग्रेट करना होगा.
आखिर में खास जानकारी
हमें आपके साथ इन बदलावों को शेयर करते हुए बहुत खुशी हो रही है. अगर आपका कोई सुझाव, राय या शिकायत है, तो कृपया हमें chromium-extensions मेलिंग लिस्ट में बताएं.