सेटिंग के ओवरराइड से एक्सटेंशन, Chrome की चुनी गई सेटिंग को बदल सकते हैं. यह एपीआई, Windows और Mac पर, Chrome के सभी मौजूदा वर्शन में उपलब्ध है.
होम पेज, खोज की सुविधा देने वाली कंपनी, और शुरुआती पेज
एक्सटेंशन मेनिफ़ेस्ट में होम पेज, खोज की सुविधा देने वाली कंपनी, और स्टार्टअप पेजों को कैसे बदला जा सकता है, इसका उदाहरण यहां दिया गया है. सेटिंग एपीआई में इस्तेमाल किए गए सभी डोमेन की पुष्टि (Google Search Console की मदद से) उसी डेवलपर खाते से की जानी चाहिए जिससे एक्सटेंशन पब्लिश किया जा रहा है. ध्यान दें कि अगर आपने किसी डोमेन (जैसे कि https://example.com) के मालिकाना हक की पुष्टि की है, तो अपने एक्सटेंशन में किसी भी सबडोमेन या पेज (उदाहरण के लिए, https://app.example.com या https://example.com/page.html) का इस्तेमाल किया जा सकता है.
सेटिंग बदलने की अनुमति का इस्तेमाल करना, जबकि अतिरिक्त सुविधाओं या अनुमतियों का अनुरोध करना, सिर्फ़ एक मकसद के लिए बनाई गई नीति से मेल नहीं खाता. जब Chrome को पता चलता है कि कोई आइटम हमारी एक ही मकसद के लिए बनाई गई नीति का उल्लंघन कर रहा है, तो उपयोगकर्ता को पुष्टि करने वाला डायलॉग दिखाया जाता है. ऐसे एक्सटेंशन जो अतिरिक्त सुविधाओं या अनुमतियों की ज़रूरत के बिना, सिर्फ़ एक सेटिंग में बदलाव करने तक सीमित रहते हैं उन्हें पुष्टि करने वाला डायलॉग नहीं मिलता.
यह बात Chrome 107 और उसके बाद के वर्शन पर लागू होती है.
{
"name": "My extension",
...
"chrome_settings_overrides": {
"homepage": "https://www.homepage.com",
"search_provider": {
"name": "name.__MSG_url_domain__",
"keyword": "keyword.__MSG_url_domain__",
"search_url": "https://www.foo.__MSG_url_domain__/s?q={searchTerms}",
"favicon_url": "https://www.foo.__MSG_url_domain__/favicon.ico",
"suggest_url": "https://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
"instant_url": "https://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
"image_url": "https://www.foo.__MSG_url_domain__/image?q={searchTerms}",
"search_url_post_params": "search_lang=__MSG_url_domain__",
"suggest_url_post_params": "suggest_lang=__MSG_url_domain__",
"instant_url_post_params": "instant_lang=__MSG_url_domain__",
"image_url_post_params": "image_lang=__MSG_url_domain__",
"alternate_urls": [
"https://www.moo.__MSG_url_domain__/s?q={searchTerms}",
"https://www.noo.__MSG_url_domain__/s?q={searchTerms}"
],
"encoding": "UTF-8",
"is_default": true
},
"startup_pages": ["https://www.startup.com"]
},
"default_locale": "de",
...
}
वैल्यू को पसंद के मुताबिक बनाना
मेनिफ़ेस्ट में मौजूद वैल्यू को इन तरीकों से पसंद के मुताबिक बनाया जा सकता है:
chrome.i18n
एपीआई का इस्तेमाल करके,search_provider
,homepage
, औरstartup_pages
प्रॉपर्टी की सभी वैल्यू को स्थानीय भाषा में बदला जा सकता है.बाहरी एक्सटेंशन के लिए,
search_provider
,homepage
, औरstartup_pages
यूआरएल वैल्यू को रजिस्ट्री कुंजी का इस्तेमाल करके पैरामीटर में बांटा जा सकता है."update_url"
कुंजी के आगे एक नई रजिस्ट्री एंट्री बनाएं (निर्देश यहां देखें). कुंजी का नाम"install_parameter"
है, मान एक आर्बिट्रेरी स्ट्रिंग है:{ "update_url": "https://clients2.google.com/service/update2/crx", "install_parameter": "Value" }
मेनिफ़ेस्ट यूआरएल में
"__PARAM__"
सबस्ट्रिंग को"install_parameter"
वैल्यू से बदल दिया जाएगा. अगर"install_parameter"
मौजूद नहीं है, तो"__PARAM__"
के इंस्टेंस हटा दिए जाते हैं. ध्यान दें कि"__PARAM__"
, होस्टनेम का हिस्सा नहीं हो सकता. यह यूआरएल में पहले '/' के बाद होना चाहिए.
रेफ़रंस
कोई एक्सटेंशन, मेनिफ़ेस्ट में इनमें से एक या ज़्यादा प्रॉपर्टी को बदल सकता है:
alternate_urls
(स्ट्रिंग का कलेक्शन, ज़रूरी नहीं)- ऐसे यूआरएल पैटर्न की सूची जिनका इस्तेमाल
search_url.
के साथ किया जा सकता है encoding
(स्ट्रिंग, ज़रूरी नहीं)- खोज के लिए इस्तेमाल किए गए शब्दों को कोड में बदलने के तरीके के बारे में जानकारी. अगर आपने
prepopulated_id
सेट नहीं किया है, तो ऐसा करना ज़रूरी है. favicon_url
(स्ट्रिंग, ज़रूरी नहीं)- सर्च इंजन के आइकॉन के लिए यूआरएल. अगर आपने
prepopulated_id
सेट नहीं किया है, तो ऐसा करना ज़रूरी है. homepage
(स्ट्रिंग, ज़रूरी नहीं)- होम पेज के लिए नई वैल्यू.
image_url
(स्ट्रिंग, ज़रूरी नहीं)- वह यूआरएल जिसका इस्तेमाल सर्च इंजन, इमेज खोजने के लिए करता है. अगर इसका इस्तेमाल नहीं किया जाता है, तो इंजन में इमेज खोजने की सुविधा काम नहीं करती.
image_url_post_params
(स्ट्रिंग, ज़रूरी नहीं)image_url
के लिए पोस्ट पैरामीटर.is_default
(बूलियन, ज़रूरी है)- यह बताता है कि खोज सेवा देने वाली कंपनी डिफ़ॉल्ट होनी चाहिए या नहीं.
keyword
(स्ट्रिंग, ज़रूरी नहीं)- सर्च इंजन के लिए खोज वाली पट्टी वाला कीवर्ड. अगर आपने
prepopulated_id
सेट नहीं किया है, तो ऐसा करना ज़रूरी है. name
(स्ट्रिंग, ज़रूरी नहीं)- उपयोगकर्ता को दिखाया जाने वाला सर्च इंजन का नाम. अगर आपने
prepopulated_id
सेट नहीं किया है, तो ऐसा करना ज़रूरी है. prepopulated_id
(पूर्णांक, वैकल्पिक)- Chrome में पहले से मौजूद सर्च इंजन का आईडी.
search_provider
(ऑब्जेक्ट, ज़रूरी नहीं)- सर्च इंजन.
search_url
(स्ट्रिंग, ज़रूरी है)- वह सर्च यूआरएल जिसका इस्तेमाल सर्च इंजन करता है.
search_url_post_params
(स्ट्रिंग, ज़रूरी नहीं)search_url
के लिए पोस्ट पैरामीटर.startup_pages
(स्ट्रिंग का कलेक्शन, ज़रूरी नहीं)- स्टार्टअप पेज के तौर पर इस्तेमाल करने के लिए लंबी अवधि का कलेक्शन, जिसमें एक यूआरएल है.
suggest_url
(स्ट्रिंग, ज़रूरी नहीं)- वह यूआरएल जिसका इस्तेमाल सर्च इंजन सुझाव दिखाने के लिए करता है. अगर इसका इस्तेमाल नहीं किया जाता है, तो इंजन पर सुझाव काम नहीं करते.
suggest_url_post_params
(स्ट्रिंग, ज़रूरी नहीं)suggest_url
के लिए पोस्ट पैरामीटर.