मैसेज यूज़र इंटरफ़ेस (यूआई) को बढ़ाना

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

ऐड-ऑन मैसेज यूज़र इंटरफ़ेस (यूआई) ऐक्सेस करना

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

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

मैसेज ऐड-ऑन बनाना

आप इन सामान्य चरणों का पालन करके किसी ऐड-ऑन में मैसेज की सुविधा जोड़ सकते हैं:

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

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

मैसेज पढ़ते समय उपयोगकर्ताओं को मदद देने के लिए, Google Workspace ऐड-ऑन अपने मेनिफ़ेस्ट में संदर्भ के हिसाब से ट्रिगर का इस्तेमाल करें. जब उपयोगकर्ता ट्रिगर को पूरा करने वाला Gmail मैसेज (ऐड-ऑन खुला होने पर) खोलता है मापदंड* ट्रिगर सक्रिय होता है. ट्रिगर किया गया ट्रिगर, संदर्भ के हिसाब से ट्रिगर फ़ंक्शन, जो का ऐड-ऑन यूज़र इंटरफ़ेस है और इसे Gmail दिखाने के लिए वापस करता है. उस समय तो उपयोगकर्ता उससे इंटरैक्ट करना शुरू कर सके.

कॉन्टेक्स्ट के हिसाब से ट्रिगर आपके ऐड-ऑन के प्रोजेक्ट में तय किए जाते हैं मेनिफ़ेस्ट में बदल दिया जाएगा. ट्रिगर की परिभाषा Gmail को यह बताती है कि कौनसा ट्रिगर फ़ंक्शन शर्तें. उदाहरण के लिए, यह मेनिफ़ेस्ट स्निपेट बिना किसी शर्त वाला ट्रिगर सेट करता है जो किसी मैसेज के खुलने पर ट्रिगर फ़ंक्शन onGmailMessageOpen() को कॉल करता है:

{
  ...
  "addOns": {

    "common": {
      ...
    },
    "gmail": {
      "contextualTriggers": [
        {
          "unconditional": {},
          "onTriggerFunction": "onGmailMessageOpen"
        }
      ],
      ...
    },
    ...
  }
  ...
}

कॉन्टेक्स्चुअल ट्रिगर फ़ंक्शन

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

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

  // Activate temporary Gmail scopes, in this case to allow
  // the add-on to read message metadata and content.
  var accessToken = e.gmail.accessToken;
  GmailApp.setCurrentMessageAccessToken(accessToken);

  // Read message metadata and content. This requires the Gmail scope
  // https://www.googleapis.com/auth/gmail.addons.current.message.readonly.
  var messageId = e.gmail.messageId;
  var message = GmailApp.getMessageById(messageId);
  var subject = message.getSubject();
  var sender = message.getFrom();
  var body = message.getPlainBody();
  var messageDate = message.getDate();

  // Setting the access token with a gmail.addons.current.message.readonly
  // scope also allows read access to the other messages in the thread.
  var thread = message.getThread();
  var threadMessages = thread.getMessages();

  // Using this link can avoid the need to copy message or thread content
  var threadLink = thread.getPermalink();

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

ट्रिगर फ़ंक्शन को बिल्ट-इन Card ऑब्जेक्ट हैं. उदाहरण के लिए, नीचे दी गई ऐसेट, एक कार्ड से एक ऐड-ऑन बनाती हैं. इसमें सिर्फ़ मैसेज का विषय और उसे भेजने वाले की जानकारी होती है:

  function onGmailMessageOpen(e) {
    // Activate temporary Gmail scopes, in this case to allow
    // message metadata to be read.
    var accessToken = e.gmail.accessToken;
    GmailApp.setCurrentMessageAccessToken(accessToken);

    var messageId = e.gmail.messageId;
    var message = GmailApp.getMessageById(messageId);
    var subject = message.getSubject();
    var sender = message.getFrom();

    // Create a card with a single card section and two widgets.
    // Be sure to execute build() to finalize the card construction.
    var exampleCard = CardService.newCardBuilder()
        .setHeader(CardService.newCardHeader()
            .setTitle('Example card'))
        .addSection(CardService.newCardSection()
            .addWidget(CardService.newKeyValue()
                .setTopLabel('Subject')
                .setContent(subject))
            .addWidget(CardService.newKeyValue()
                .setTopLabel('From')
                .setContent(sender)))
        .build();   // Don't forget to build the Card!
    return [exampleCard];
  }