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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ऐड-ऑन की अनुमति देने वाला कार्ड

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ऐड-ऑन से अनुमति वापस लेना

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

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

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

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

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

Google Workspace Marketplace से इंस्टॉल किए गए किसी ऐड-ऑन को अनइंस्टॉल करने के लिए, Marketplace से इंस्टॉल किए गए किसी ऐप्लिकेशन या ऐड-ऑन को अनइंस्टॉल करना लेख पढ़ें.

Apps Script में बनाए गए, अनपब्लिश किए गए ऐड-ऑन को अनइंस्टॉल करने के लिए, अनपब्लिश किए गए ऐड-ऑन को अनइंस्टॉल करना लेख पढ़ें.