ऐड-ऑन इंस्टॉल करना और उन्हें अनुमति देना

किसी ऐड-ऑन को खोलने और उसका इस्तेमाल करने से पहले, उपयोगकर्ताओं को उसे इंस्टॉल करना होगा और उसकी अनुमति देनी होगी. ये चरण, ऐड-ऑन उपयोगकर्ता अनुभव का पहला हिस्सा हैं. इसलिए, अपने ऐड-ऑन बनाने से पहले आपको इन्हें समझ लेना चाहिए.

इस दस्तावेज़ के सेक्शन में बताया गया है कि उपयोगकर्ता ऐड-ऑन कैसे इंस्टॉल कर सकते हैं, कैसे अनुमति दे सकते हैं, और उन्हें इस्तेमाल करना कैसे शुरू कर सकते हैं.

ऐड-ऑन इंस्टॉल करें

ऐड-ऑन का इस्तेमाल करने से पहले, आपको इसे इंस्टॉल करना होगा. इंस्टॉल होने के बाद, ऐड-ऑन Google Workspace होस्ट ऐप्लिकेशन में उपलब्ध हो जाता है.

पब्लिश किए गए ऐड-ऑन, Google Workspace होस्ट ऐप्लिकेशन या Google Workspace Marketplace से इंस्टॉल किए जा सकते हैं. डोमेन एडमिन अपने उपयोगकर्ताओं के लिए, Google Workspace Marketplace से ऐड-ऑन भी इंस्टॉल कर सकते हैं. डेवलप किए जा रहे अनपब्लिश किए गए ऐड-ऑन भी इंस्टॉल किए जा सकते हैं, ताकि आप उनकी जांच कर सकें. इंस्टॉल किए गए किसी ऐड-ऑन का पहली बार इस्तेमाल करने से पहले, आपको उसे अनुमति देनी होगी.

ज़्यादा जानकारी के लिए, ऐड-ऑन पब्लिश करना देखें.

ऐड-ऑन को अनुमति देना

ऐड-ऑन इंस्टॉल करने के बाद, यह Google Workspace host ऐप्लिकेशन में उपलब्ध हो जाता है. इसके और फ़ायदे मिलने की सुविधा चालू हो जाती है. जब कोई उपयोगकर्ता पहली बार ऐड-ऑन होस्ट ऐप्लिकेशन का इस्तेमाल करने की कोशिश करता है, तो उसे एक ऑथराइज़ेशन कार्ड या डायलॉग दिखता है. यह कार्ड बताता है कि ऐड-ऑन को उपयोगकर्ता से क्या-क्या करने की अनुमति चाहिए, जैसे कि मौजूदा Google शीट का कॉन्टेंट ऐक्सेस करना. इसके बाद, उपयोगकर्ता उन अनुमतियों को दे सकता है और ऐड-ऑन को आगे बढ़ने की अनुमति दे सकता है. अगर उपयोगकर्ता, ऐड-ऑन की अनुमति नहीं देता है, तो वह ऐड-ऑन का इस्तेमाल नहीं कर सकता.

Editor ऐड-ऑन, अनुमति देने वाले ऐसे मॉडल का इस्तेमाल करते हैं जो Google Workspace ऐड-ऑन से अलग होता है. एडिटर ऐड-ऑन, Google Drive की फ़ाइलों पर काम करते हैं. इसलिए, 'एडिटर की अनुमति वाला मॉडल', अनुमति देने वाले कई तरह के मोड के बारे में बताता है. ये मोड तब बनते हैं, जब अलग-अलग फ़ाइलों के साथ ऐड-ऑन का इस्तेमाल किया जाता है. एडिटर ऐड-ऑन बनाते समय, अलग-अलग मोड के बारे में समझना ज़रूरी है. साथ ही, यह समझना भी ज़रूरी है कि उनके बीच ऐड-ऑन कैसे काम करता है.

पब्लिश किए गए ऐड-ऑन को अनुमति देना

पब्लिश किए गए ऐड-ऑन को इंस्टॉल करने के बाद, अनुमति देने की प्रोसेस तुरंत शुरू हो जाती है:

1. ऐड-ऑन इंस्टॉल करने के लिए, आपको कोई खाता चुनें का विकल्प दिखेगा.
2. इसके बाद, आपको उन अनुमतियों की सूची दी जाती है जो ऐड-ऑन को ऑपरेट करने के लिए ज़रूरी हैं. इससे आपको पता चलेगा कि वह क्या करने की कोशिश कर रहा है. इस सूची को ध्यान से पढ़ें और अगर आपको अब भी अनुमति देनी है, तो अनुमति दें पर क्लिक करें. इससे, ऐड-ऑन का इस्तेमाल शुरू हो जाता है.
3. अब इसे होस्ट ऐप्लिकेशन से चलाया जा सकता है. अगर ऐप्लिकेशन पहले से ही किसी ब्राउज़र टैब में खुला हुआ है, तो हो सकता है कि आपको ऐड-ऑन उपलब्ध होने से पहले इस टैब को रीफ़्रेश करना पड़े.

अगर इंस्टॉल किए गए ऐड-ऑन को बाद में अपडेट किया जाता है और उसे कुछ और अनुमतियों की ज़रूरत होती है जो आपने अभी तक नहीं दी हैं, तो अगली बार उस ऐड-ऑन का इस्तेमाल करते समय आपको वे अनुमतियां देने के लिए कहा जाएगा.

पब्लिश नहीं किए गए Google Workspace ऐड-ऑन को अनुमति दें

अनपब्लिश किए गए ऐड-ऑन का अनुमति फ़्लो, पब्लिश किए गए ऐड-ऑन की तरह नहीं होता. ऐसा इसलिए, क्योंकि ये ऐड-ऑन अब तक Google Workspace Marketplace में उपलब्ध नहीं हैं. पब्लिश नहीं किया गया ऐड-ऑन इंस्टॉल करने के बाद, आपको तुरंत अनुमति देने के लिए नहीं कहा जाता. इसके बजाय, ऐड-ऑन का पहली बार इस्तेमाल करने पर ऑथराइज़ेशन फ़्लो शुरू हो जाता है.

ऐड-ऑन चलाते समय यह तय होता है कि किसी उपयोगकर्ता की अनुमति की ज़रूरत है या नहीं. अगर अनुमति ज़रूरी है, तो ऐड-ऑन, एक ऑथराइज़ेशन कार्ड दिखाता है. ऐड-ऑन को पहली बार चलाने पर हमेशा अनुमति देना ज़रूरी होता है. अगर ऐड-ऑन का नया वर्शन किसी ऐसी सेवा का इस्तेमाल कर रहा है जिसे पहले अनुमति नहीं मिली है, तब भी अनुमति की ज़रूरत पड़ सकती है. ऐक्सेस की अनुमति दें बटन, उपयोगकर्ता को ऐड-ऑन को अनुमति देने या न देने के लिए एक डायलॉग विंडो उपलब्ध कराता है.

Google Workspace ऐड-ऑन के लिए, Google से बाहर की सेवाओं को अनुमति देना

Google Workspace ऐड-ऑन, तीसरे पक्ष की किसी ऐसी सेवा से कनेक्ट कर सकता है जिसके लिए अनुमति की ज़रूरत होती है. इस तरह की सेवाओं से कनेक्ट करने वाले Google Workspace ऐड-ऑन के लिए, उपयोगकर्ता को दो अलग-अलग कार्रवाइयां करनी होती हैं:

• ऐड-ऑन के इंस्टॉल होने या उसे पहली बार शुरू करने पर, उसे अपने-आप अनुमति देना.
• Google से बाहर की किसी सेवा को पहली बार ऐक्सेस करने पर उसे अनुमति देना.

अगर आप किसी Google Workspace ऐड-ऑन के लिए OAuth का इस्तेमाल करके, Google से बाहर की किसी सेवा को ऐक्सेस करना चाहते हैं, तो आपको यह ऐड-ऑन बनाते समय उस सेवा के लिए कनेक्शन कॉन्फ़िगर करना होगा.

ज़्यादा जानकारी के लिए, अपने Google Workspace ऐड-ऑन को तीसरे पक्ष की सेवा से कनेक्ट करना लेख पढ़ें.

तीसरे पक्ष के कॉन्फ़्रेंसिंग सिस्टम

Google Workspace ऐड-ऑन, जो Google Calendar का इस्तेमाल करते हैं वे अतिरिक्त कॉन्फ़्रेंसिंग समाधान भी जोड़ सकते हैं. इनकी मदद से उपयोगकर्ता, Google Calendar इवेंट में बदलाव करते समय तीसरे पक्ष का कॉन्फ़्रेंसिंग सिस्टम चुन सकते हैं. अगर आपके ऐड-ऑन में ऐसी कॉन्फ़्रेंसिंग के विकल्प मौजूद हैं जिनके लिए उपयोगकर्ता को उनमें लॉग इन करना ज़रूरी है, तो आपके ऐड-ऑन को उपयोगकर्ता को ऐसा करने की सुविधा देनी चाहिए.

अगर कोई उपयोगकर्ता ज़रूरी साइन इन किए बिना आपके ऐड-ऑन के साथ कॉन्फ़्रेंस बनाने की कोशिश करता है, तो कॉन्फ़्रेंस के onCreateFunction तरीके से ConferenceError वाला एक ऑब्जेक्ट ConferenceData मिलना चाहिए, जिसमें पुष्टि करने वाला यूआरएल शामिल हो.

यह ऑब्जेक्ट मिलने पर, Google Calendar इवेंट में बदलाव करने वाले यूज़र इंटरफ़ेस (यूआई) में एक लॉग इन करें बटन बनाता है जो ऐड-ऑन से मिलने वाले पुष्टि करने वाले यूआरएल से लिंक होता है. इसके बाद, उपयोगकर्ता इस बटन का इस्तेमाल करके ऐड-ऑन का आगे इस्तेमाल करने से पहले तीसरे पक्ष के सिस्टम में लॉग इन कर सकते हैं.

ConferenceError का इस्तेमाल करके, अनुमति मैनेज करने के बारे में ज़्यादा जानकारी के लिए, तीसरे पक्ष की कॉन्फ़्रेंस बनाना लेख पढ़ें.

पब्लिश नहीं किए गए एडिटर ऐड-ऑन को अनुमति देना

सबसे सही तरीका यह है कि एडिटर के ऐड-ऑन को टेस्ट करना शुरू करें. अनुमति देने का फ़्लो, पब्लिश किए गए एडिटर ऐड-ऑन की तरह ही होता है. हालांकि, पहली बार ऐड-ऑन की जांच करने के बाद ही फ़्लो शुरू हो जाता है. अगर बाद में उसी ऐड-ऑन की फिर से जांच की जाती है, तो आपको फिर से अनुमति देने के लिए नहीं कहा जाएगा.

ऐड-ऑन की अनुमति हटाएं

ऐड-ऑन डेवलप करते समय, उनकी अनुमति रद्द करना फ़ायदेमंद हो सकता है, ताकि आप अनुमति देने वाले फ़्लो की फिर से जांच कर सकें.

किसी ऐड-ऑन की अनुमति हटाने के लिए, यह तरीका अपनाएं:

1. अपने खाते का सुरक्षा कंसोल खोलें.
2. उस ऐड-ऑन को ढूंढें और उस पर क्लिक करें जिसकी अनुमति आपको हटानी है.
3. ऐक्सेस हटाएं पर क्लिक करें.

जब ऐड-ऑन को अनलिंक करने के बाद उसे फिर से चलाया जाता है, तो अनुमति देने वाला फ़्लो फिर से दिखता है.

मिलते-जुलते विषय

• इंस्टॉल किए गए ऐड-ऑन खोलना और उनका इस्तेमाल करना
• अपने Google Workspace ऐड-ऑन को तीसरे पक्ष की सेवा से कनेक्ट करना