Package google.apps.script.type.gmail

इंडेक्स

• ComposeTrigger (मैसेज)
• ComposeTrigger.DraftAccess (enum)
• ContextualTrigger (मैसेज)
• GmailAddOnManifest (मैसेज)
• UnconditionalTrigger (मैसेज)
• UniversalAction (मैसेज)

ComposeTrigger

एक ट्रिगर, जो उपयोगकर्ता के ईमेल लिखते समय चालू हो जाता है.

फ़ील्ड
actions[]	MenuItemExtensionPoint कंपोज़ टाइम ऐड-ऑन के लिए कार्रवाइयों के सेट के बारे में बताता है. ये ऐसी कार्रवाइयां हैं जिन्हें उपयोगकर्ता, 'लिखने के समय' ऐड-ऑन पर ट्रिगर कर सकते हैं.
draftAccess	DraftAccess कंपोज़ करने के समय वाला ऐड-ऑन ट्रिगर होने पर, डेटा के ऐक्सेस का लेवल तय करता है.

DraftAccess

'लिखें' ट्रिगर के लिए ज़रूरी डेटा ऐक्सेस लेवल को तय करने वाली Enum.

Enums
UNSPECIFIED	ड्राफ़्ट ऐक्सेस के लिए कुछ भी सेट न होने पर, डिफ़ॉल्ट वैल्यू.
NONE	'लिखें' ऐड-ऑन ट्रिगर होने पर, 'लिखें' ट्रिगर, ड्राफ़्ट के किसी भी डेटा को ऐक्सेस नहीं कर सकता.
METADATA	कंपोज़ ऐड-ऑन ट्रिगर होने पर, 'लिखें' ट्रिगर को ड्राफ़्ट के मेटाडेटा को ऐक्सेस करने की अनुमति देता है. इसमें ऑडियंस की सूची शामिल होती है. जैसे, किसी ड्राफ़्ट मैसेज की 'पाने वाला' और 'कॉपी' सूची.

ContextualTrigger

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

फ़ील्ड
onTriggerFunction	string ज़रूरी है. मैसेज के ट्रिगर से मैच होने पर, कॉल करने के लिए एंडपॉइंट का नाम.
यूनियन फ़ील्ड trigger. ट्रिगर के टाइप से उन शर्तों के बारे में पता चलता है जिनका इस्तेमाल Gmail, ऐड-ऑन दिखाने के लिए करता है. trigger इनमें से सिर्फ़ एक हो सकता है:
unconditional	UnconditionalTrigger बिना शर्त वाले ट्रिगर तब चलाए जाते हैं, जब कोई मेल मैसेज खोला जाता है.

GmailAddOnManifest

Gmail ऐड-ऑन के दिखने का तरीका और उसके काम करने के तरीके को पसंद के मुताबिक बनाने वाली प्रॉपर्टी.

फ़ील्ड
homepageTrigger	HomepageExtensionPoint यह ऐसे एंडपॉइंट के बारे में बताता है जिसे उन कॉन्टेक्स्ट में एक्ज़ीक्यूट किया जाएगा जो एलान किए गए काम के ट्रिगर से मैच नहीं करते. इस फ़ंक्शन से जनरेट किए गए सभी कार्ड, उपयोगकर्ता के लिए हमेशा उपलब्ध रहेंगे. हालांकि, अगर यह ऐड-ऑन ज़्यादा टारगेट किए गए ट्रिगर का एलान करता है, तो हो सकता है कि काम के कॉन्टेंट की वजह से उस कार्ड का इस्तेमाल न किया जाए. मौजूद होने पर, यह addOns.common.homepageTrigger के कॉन्फ़िगरेशन को बदल देता है.
contextualTriggers[]	ContextualTrigger ऐड-ऑन को ट्रिगर करने वाली शर्तों के सेट को तय करता है.
universalActions[]	UniversalAction यह ऐड-ऑन के लिए यूनिवर्सल ऐक्शन के सेट के बारे में बताता है. उपयोगकर्ता, ऐड-ऑन टूलबार मेन्यू से यूनिवर्सल ऐक्शन ट्रिगर करता है.
composeTrigger	ComposeTrigger कंपोज़ करने के समय वाले ऐड-ऑन के लिए, कंपोज़ करने के समय का ट्रिगर तय करता है. यह वह ट्रिगर है, जिसकी वजह से ऐड-ऑन तब कार्रवाई करता है, जब उपयोगकर्ता कोई ईमेल लिखता है. लिखने के समय वाले सभी ऐड-ऑन के पास gmail.addons.current.action.compose स्कोप होना चाहिए, भले ही वह ड्राफ़्ट में बदलाव न करता हो.
authorizationCheckFunction	string उस एंडपॉइंट का नाम जो तीसरे पक्ष के एपीआई की जांच करके, इस बात की पुष्टि करता है कि ऐड-ऑन के पास तीसरे पक्ष से जुड़ी सभी ज़रूरी अनुमतियां हैं या नहीं. अगर जांच पूरी नहीं हो पाती है, तो ऑथराइज़ेशन फ़्लो शुरू करने के लिए फ़ंक्शन को एक अपवाद देना चाहिए. इस फ़ंक्शन को ऐड-ऑन के हर अनुरोध से पहले कॉल किया जाता है, ताकि उपयोगकर्ताओं को बेहतर अनुभव मिल सके.

UnconditionalTrigger

इस टाइप के लिए कोई फ़ील्ड नहीं है.

एक ट्रिगर, जो कोई भी ईमेल मैसेज खोले जाने पर सक्रिय होता है.

UniversalAction

यह एक ऐसी कार्रवाई है जो ऐड-ऑन टूलबार मेन्यू में हमेशा उपलब्ध होती है. इस बात से कोई फ़र्क़ नहीं पड़ता कि मैसेज का संदर्भ क्या है.

फ़ील्ड
text	string ज़रूरी है. उपयोगकर्ता को दिखने वाला टेक्स्ट, जिसमें कार्रवाई के बारे में बताया गया हो. जैसे, "नया संपर्क जोड़ें."
यूनियन फ़ील्ड action_type. इस तरह की कार्रवाई से तय होता है कि Gmail कैसे कार्रवाई करेगा. action_type इनमें से सिर्फ़ एक हो सकता है:
openLink	string यह एक लिंक है, जिसे Gmail उपयोगकर्ता के कार्रवाई को ट्रिगर करने पर खोलता है.
runFunction	string एक एंडपॉइंट जिसे उपयोगकर्ता के कार्रवाई को ट्रिगर करने पर कॉल किया जाता है. ज़्यादा जानकारी के लिए, सभी के लिए बनी कार्रवाइयों की गाइड देखें.