शब्दावली

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

Calendar conferencing add-on

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

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

कार्ड

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

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

कार्ड पर आधारित

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

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

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

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

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

कॉन्फ़्रेंसिंग के विकल्प

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

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

कॉन्टेक्स्ट

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

कॉन्टेक्स्ट के हिसाब से ट्रिगर करना

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

एडिटर ऐड-ऑन

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

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

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

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

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

Gmail ऐड-ऑन

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

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

होम पेज

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

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

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

Google Workspace ऐप्लिकेशन, Google Workspace ऐड-ऑन को बढ़ाता है. जैसे, Gmail या Google Calendar.

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

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

लिंक की झलक दिखाने की सुविधा ट्रिगर करना

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

ज़्यादा जानकारी के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

मेनिफ़ेस्ट

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

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

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

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

संदर्भ के हिसाब से नहीं दिखाए जाने वाले कार्ड

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

साइडबार

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

स्मार्ट चिप

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

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

ट्रिगर

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

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

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

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

विजेट

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

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

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

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

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