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

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

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

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

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

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

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

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

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

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

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

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

  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 तरीके से एक ConferenceData ऑब्जेक्ट दिखना चाहिए. इसमें ConferenceError और पुष्टि करने वाला यूआरएल शामिल होना चाहिए.

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

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

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

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

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

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

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

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

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

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

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

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