शब्दावली

इस दस्तावेज़ में इन शब्दों का इस्तेमाल किया गया है.

कैलेंडर कॉन्फ़्रेंसिंग ऐड-ऑन

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

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

कार्ड

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

ज़्यादा जानकारी के लिए कार्ड देखें.

कार्ड के हिसाब से

एक ऐड-ऑन, जिसका यूज़र इंटरफ़ेस साइडबार में पैनल के तौर पर या मोबाइल पर, मेन्यू से किसी दूसरी गतिविधि विंडो के तौर पर दिखता है. ऐड-ऑन में सबसे ऊपर एक टूलबार होता है, जो ऐड-ऑन की पहचान करता है और कार्ड दिखाता है. यह ऐड-ऑन यूज़र इंटरफ़ेस (यूआई) का "पेज" होता है.

Google Workspace ऐड-ऑन, कार्ड के हिसाब से होते हैं.

कॉन्फ़्रेंस का डेटा

उपयोगकर्ताओं को Google Workspace ऐड-ऑन या Calendar कॉन्फ़्रेंसिंग ऐड-ऑन से चालू की गई तीसरे पक्ष की कॉन्फ़्रेंस बनाने और उनमें शामिल होने की अनुमति देने के लिए, Google Calendar को जानकारी देना ज़रूरी होता है.

ज़्यादा जानकारी के लिए, कॉन्फ़्रेंस डेटा देखें.

कॉन्फ़्रेंस सलूशन

तीसरे पक्ष की ऐसी कॉन्फ़्रेंस जिसे Google Workspace ऐड-ऑन या Calendar कॉन्फ़्रेंसिंग ऐड-ऑन का इस्तेमाल करके, Google Calendar से बनाया जा सकता है.

ज़्यादा जानकारी के लिए, कॉन्फ़्रेंस के समाधान देखें.

कॉन्टेक्स्ट

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

कॉन्टेक्स्चुअल ट्रिगर करना

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

एडिटर ऐड-ऑन

ऐड-ऑन टाइप का ओरिजनल सेट, जिसमें सिर्फ़ Google Docs, Sheets, Forms या Slides के एक्सटेंशन की अनुमति थी. Editor ऐड-ऑन, कार्ड-आधारित नहीं होते हैं. इनके लिए, डेवलपर को रॉ एचटीएमएल और सीएसएस से यूज़र इंटरफ़ेस (यूआई) बनाना ज़रूरी होता है. हर एडिटर ऐड-ऑन, सिर्फ़ एक होस्ट ऐप्लिकेशन का इस्तेमाल कर सकता है.

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

इवेंट ऑब्जेक्ट

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

ज़्यादा जानकारी के लिए इवेंट ऑब्जेक्ट देखें.

Gmail ऐड-ऑन

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

अधिक जानकारी के लिए Gmail ऐड-ऑन देखें. साथ ही, Gmail ऐड-ऑन को Google Workspace ऐड-ऑन में बदलने का तरीका जानने के लिए, पब्लिश किए गए ऐड-ऑन को अपग्रेड करना देखें.

होम पेज

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

ज़्यादा जानकारी के लिए, होम पेज देखें.

होस्ट या होस्ट ऐप्लिकेशन

Google Workspace ऐड-ऑन के तौर पर, Google Workspace ऐप्लिकेशन का इस्तेमाल Gmail या Google Calendar जैसे किया जाता है.

एचटीएमएल-आधारित

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

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

ज़्यादा जानकारी के लिए, Google Docs में लिंक की झलक देखें देखें.

मेनिफ़ेस्ट

Apps Script प्रोजेक्ट में एक JSON फ़ाइल अटैच की गई है. मेनिफ़ेस्ट का इस्तेमाल प्रोजेक्ट की वह जानकारी तय करने के लिए किया जाता है जिसे स्क्रिप्ट को सही तरीके से चलाने की ज़रूरत होती है. Google Workspace ऐड-ऑन के लिए, मेनिफ़ेस्ट का इस्तेमाल यह बताने के लिए किया जाता है कि ऐड-ऑन को किन चीज़ों के लिए ज़्यादा इस्तेमाल किया जा सकता है. साथ ही, यूज़र इंटरफ़ेस (यूआई) को कंट्रोल करने की कुछ सेटिंग उपलब्ध कराई जाती हैं.

मेनिफ़ेस्ट ट्रिगर

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

मेनिफ़ेस्ट ट्रिगर, Apps Script के दूसरे ट्रिगर से अलग होते हैं. ये पहले से मौजूद नहीं होते (जैसे सिंपल ट्रिगर) और इन्हें Apps Script स्क्रिप्ट सेवा (जैसे, इंस्टॉल किए जा सकने वाले ट्रिगर) की मदद से, प्रोग्राम के हिसाब से नहीं बनाया जा सकता.

ऐसे कार्ड जो काम के नहीं हैं

ऐसे कार्ड जो तब कॉन्टेंट दिखाते हैं, जब लोग किसी खास कॉन्टेक्स्ट से बाहर होते हैं. उदाहरण के लिए, ऐसे कार्ड जो Gmail में अपने ईमेल थ्रेड देखते समय कॉन्टेंट दिखाते हैं, लेकिन उसे खोला नहीं गया हो. होम पेज एक तरह का गैर-संदर्भ कार्ड होता है.

होस्ट के यूज़र इंटरफ़ेस (यूआई) के दाईं ओर मौजूद सेक्शन, जहां Google Workspace ऐड-ऑन का यूज़र इंटरफ़ेस (यूआई) दिखता है. Gmail और Editor ऐड-ऑन भी साइडबार तय कर सकते हैं.

स्मार्ट चिप

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

स्मार्ट चिप का इस्तेमाल करने के लिए, ऐड-ऑन को कॉन्फ़िगर किया जा सकता है. इससे किसी तीसरे पक्ष या Google से बाहर की सेवा के लिंक की झलक देखी जा सकती है. Google Docs में लिंक की झलक देखना देखें.

ट्रिगर

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

ज़्यादा जानकारी के लिए ऐड-ऑन ट्रिगर देखें.

फ़ंक्शन को ट्रिगर करें

किसी प्रोजेक्ट में Apps Script फ़ंक्शन, जो किसी ट्रिगर के ट्रिगर होने पर काम करता है.

विजेट

यूज़र इंटरफ़ेस (यूआई) एलिमेंट, जैसे कि बटन, टेक्स्ट फ़ील्ड या चेकबॉक्स. कार्ड, विजेट ऑब्जेक्ट के क्रम से बनाए जाते हैं. इनके बारे में Apps Script की मदद से, पहले से मौजूद कार्ड सेवा तय किया जाता है.

ज़्यादा जानकारी के लिए, विजेट देखें.

विजेट हैंडलर फ़ंक्शन

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

ज़्यादा जानकारी के लिए, Widget हैंडलर फ़ंक्शन देखें.