Class DecoratedText

DecoratedText

वैकल्पिक सजावट वाला टेक्स्ट दिखाने वाला विजेट. संभावित कुंजियों में एक आइकॉन, ऊपर एक लेबल और नीचे एक लेबल शामिल हो सकते हैं. setText(text) और DecoratedText, DecoratedText, setTopLabel(text) या setBottomLabel(text) में से किसी एक का इस्तेमाल करके, टेक्स्ट कॉन्टेंट और कोई एक बटन सेट करना ज़रूरी है. इस क्लास का मकसद KeyValue को बदलना है.

यह सुविधा, Google Workspace ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.

var decoratedText = CardService.newDecoratedText()
    .setText("Text")
    .setTopLabel("TopLabel");

var multilineDecoratedText = CardService.newDecoratedText()
    .setText("Text")
    .setTopLabel("TopLabel")
    .setWrapText(true)
    .setBottomLabel("BottomLabel");

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
setAuthorizationAction(action)	DecoratedText	अनुमति देने की कार्रवाई सेट करता है, जो ऑब्जेक्ट पर क्लिक करने पर अनुमति देने वाले फ़्लो को एक यूआरएल खोलता है.
setBottomLabel(text)	DecoratedText	लेबल टेक्स्ट को कुंजी के रूप में इस्तेमाल करने के लिए सेट करता है और टेक्स्ट कॉन्टेंट के नीचे दिखाया जाता है.
setButton(button)	DecoratedText	टेक्स्ट की दाईं ओर दिखने वाले Button को सेट करता है.
setComposeAction(action, composedEmailType)	DecoratedText	ऑब्जेक्ट के क्लिक होने पर, ड्राफ़्ट ईमेल बनाने वाली कार्रवाई सेट करता है.
setEndIcon(endIcon)	DecoratedText	कॉन्टेंट की दाईं ओर दिखने वाले वैकल्पिक IconImage को सेट करता है.
setOnClickAction(action)	DecoratedText	ऑब्जेक्ट पर क्लिक होने पर, एक कार्रवाई सेट करता है.
setOnClickOpenLinkAction(action)	DecoratedText	ऑब्जेक्ट को क्लिक करने पर, टैब में यूआरएल खोलने वाली कार्रवाई सेट की जाती है.
setOpenLink(openLink)	DecoratedText	ऑब्जेक्ट के क्लिक होने पर खुलने वाला यूआरएल सेट करता है.
setStartIcon(startIcon)	DecoratedText	टेक्स्ट कॉन्टेंट से पहले दिखाने के लिए, वैकल्पिक IconImage सेट करता है.
setSwitchControl(switchToSet)	DecoratedText	कॉन्टेंट की दाईं ओर दिखने वाले Switch को सेट करता है.
setText(text)	DecoratedText	वैल्यू के तौर पर इस्तेमाल किए जाने वाले टेक्स्ट को सेट करता है.
setTopLabel(text)	DecoratedText	लेबल टेक्स्ट को कुंजी के रूप में इस्तेमाल करने के लिए सेट करता है और टेक्स्ट कॉन्टेंट के ऊपर दिखाया जाता है.
setWrapText(wrapText)	DecoratedText	सेट करता है कि वैल्यू टेक्स्ट, एक लाइन में दिखाया जाए या कई लाइनों में.

ज़्यादा जानकारी वाला दस्तावेज़

setAuthorizationAction(action)

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

यूज़र इंटरफ़ेस (यूआई) ऑब्जेक्ट में setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) या setComposeAction(action, composedEmailType) में से सिर्फ़ एक सेट हो सकता है.

// ...

var action = CardService.newAuthorizationAction().setAuthorizationUrl('url');
CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);

पैरामीटर

नाम	टाइप	ब्यौरा
action	AuthorizationAction	वह ऑब्जेक्ट जो इस एलिमेंट पर क्लिक होने के बाद की जाने वाली अनुमति देने की कार्रवाई तय करता है.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setBottomLabel(text)

लेबल टेक्स्ट को कुंजी के रूप में इस्तेमाल करने के लिए सेट करता है और टेक्स्ट कॉन्टेंट के नीचे दिखाया जाता है.

पैरामीटर

नाम	टाइप	ब्यौरा
text	String	लेबल टेक्स्ट.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setButton(button)

टेक्स्ट की दाईं ओर दिखने वाले Button को सेट करता है. DecoratedText में सिर्फ़ एक बटन या एक स्विच इस्तेमाल किया जा सकता है.

पैरामीटर

नाम	टाइप	ब्यौरा
button	Button	जोड़ने के लिए बटन.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setComposeAction(action, composedEmailType)

ऑब्जेक्ट के क्लिक होने पर, ड्राफ़्ट ईमेल बनाने वाली कार्रवाई सेट करता है. यूज़र इंटरफ़ेस (यूआई) ऑब्जेक्ट में setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) या setComposeAction(action, composedEmailType) में से सिर्फ़ एक को सेट किया जा सकता है.

Action पैरामीटर को उस कॉलबैक फ़ंक्शन के बारे में बताना होगा जो ComposeActionResponseBuilder.setGmailDraft(draft) का इस्तेमाल करके कॉन्फ़िगर किया गया ComposeActionResponse ऑब्जेक्ट दिखाता है.

ध्यान दें: इस तरीके से, लिखें के यूज़र इंटरफ़ेस (यूआई) को बढ़ाने के लिए, कंपोज़ ऐक्शन सेट नहीं किया जाता. इसके बजाय, यह तरीका इस यूज़र इंटरफ़ेस (यूआई) एलिमेंट को Action से कनेक्ट करता है. यह Apps Script में ड्राफ़्ट मैसेज बनाता है. ये मैसेज, कार्रवाई पूरी होने पर Gmail में खुलते हैं.

// ...

var action = CardService.newAction().setFunctionName('composeEmailCallback');
CardService.newTextButton()
    .setText('Compose Email')
    .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT);

// ...

function composeEmailCallback() {
  var thread = GmailApp.getThreadById(e.threadId);
  var draft = thread.createDraftReply('This is a reply');
  return CardService.newComposeActionResponseBuilder()
      .setGmailDraft(draft)
      .build();
}

पैरामीटर

नाम	टाइप	ब्यौरा
action	Action	वह ऑब्जेक्ट जो इस एलिमेंट पर क्लिक होने के बाद की जाने वाली ‘लिखने की कार्रवाई’ तय करता है.
composedEmailType	ComposedEmailType	इनम वैल्यू, जिससे यह पता चलता है कि बनाया गया ड्राफ़्ट, स्टैंडअलोन ड्राफ़्ट है या जवाब का ड्राफ़्ट.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setEndIcon(endIcon)

कॉन्टेंट की दाईं ओर दिखने वाले वैकल्पिक IconImage को सेट करता है. DecoratedText में सिर्फ़ एक बटन, एक स्विच या एक आइकॉन के साथ काम किया जा सकता है.

पैरामीटर

नाम	टाइप	ब्यौरा
endIcon	IconImage	जोड़ने के लिए आइकॉन.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setOnClickAction(action)

ऑब्जेक्ट पर क्लिक होने पर, एक कार्रवाई सेट करता है. यूज़र इंटरफ़ेस (यूआई) ऑब्जेक्ट में setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) या setComposeAction(action, composedEmailType) में से सिर्फ़ एक सेट हो सकता है.

Action पैरामीटर को उस कॉलबैक फ़ंक्शन के बारे में बताना होगा जो ActionResponse ऑब्जेक्ट दिखाता है.

// ...

var action = CardService.newAction().setFunctionName('notificationCallback');
CardService.newTextButton().setText('Create notification').setOnClickAction(action);

// ...

function notificationCallback() {
  return CardService.newActionResponseBuilder()
      .setNotification(CardService.newNotification()
          .setText("Some info to display to user"))
      .build();
}

पैरामीटर

नाम	टाइप	ब्यौरा
action	Action	इस एलिमेंट पर क्लिक करने पर की जाने वाली कार्रवाई.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setOnClickOpenLinkAction(action)

ऑब्जेक्ट को क्लिक करने पर, टैब में यूआरएल खोलने वाली कार्रवाई सेट की जाती है. इस फ़ंक्शन का इस्तेमाल तब करें, जब यूआरएल बनाने की ज़रूरत हो या जब आपको OpenLink ऑब्जेक्ट बनाने के लिए अन्य कार्रवाइयां करनी हों. यूज़र इंटरफ़ेस (यूआई) ऑब्जेक्ट में setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) या setComposeAction(action, composedEmailType) में से सिर्फ़ एक सेट हो सकता है.

Action पैरामीटर को उस कॉलबैक फ़ंक्शन के बारे में बताना होगा जो ActionResponseBuilder.setOpenLink(openLink) का इस्तेमाल करके कॉन्फ़िगर किया गया ActionResponse ऑब्जेक्ट दिखाता है.

// ...

var action = CardService.newAction().setFunctionName('openLinkCallback');
CardService.newTextButton().setText('Open Link').setOnClickOpenLinkAction(action);

// ...

function openLinkCallback() {
  return CardService.newActionResponseBuilder()
      .setOpenLink(CardService.newOpenLink()
          .setUrl('https://www.google.com'))
      .build();
}

पैरामीटर

नाम	टाइप	ब्यौरा
action	Action	वह ऑब्जेक्ट जो इस एलिमेंट पर क्लिक होने के बाद की जाने वाली ओपन लिंक कार्रवाई के बारे में बताता है.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setOpenLink(openLink)

ऑब्जेक्ट के क्लिक होने पर खुलने वाला यूआरएल सेट करता है. इस फ़ंक्शन का इस्तेमाल तब करें, जब यूआरएल के बारे में पहले से जानकारी हो और उसे सिर्फ़ खोलने की ज़रूरत हो. यूज़र इंटरफ़ेस (यूआई) ऑब्जेक्ट में setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) या setComposeAction(action, composedEmailType) में से सिर्फ़ एक सेट हो सकता है.

पैरामीटर

नाम	टाइप	ब्यौरा
openLink	OpenLink	OpenLink ऑब्जेक्ट, जिसमें खुलने वाले यूआरएल के बारे में जानकारी दी गई है.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setStartIcon(startIcon)

टेक्स्ट कॉन्टेंट से पहले दिखाने के लिए, वैकल्पिक IconImage सेट करता है.

पैरामीटर

नाम	टाइप	ब्यौरा
startIcon	IconImage	दिखाया जाने वाला आइकॉन.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setSwitchControl(switchToSet)

कॉन्टेंट की दाईं ओर दिखने वाले Switch को सेट करता है. DecoratedText में सिर्फ़ एक बटन या एक स्विच इस्तेमाल किया जा सकता है.

पैरामीटर

नाम	टाइप	ब्यौरा
switchToSet	Switch	जोड़ने के लिए स्विच.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setText(text)

वैल्यू के तौर पर इस्तेमाल किए जाने वाले टेक्स्ट को सेट करता है. बेसिक एचटीएमएल फ़ॉर्मैटिंग पर काम करता है. ज़रूरी है.

पैरामीटर

नाम	टाइप	ब्यौरा
text	String	इस विजेट के लिए टेक्स्ट कॉन्टेंट.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setTopLabel(text)

लेबल टेक्स्ट को कुंजी के रूप में इस्तेमाल करने के लिए सेट करता है और टेक्स्ट कॉन्टेंट के ऊपर दिखाया जाता है.

पैरामीटर

नाम	टाइप	ब्यौरा
text	String	लेबल टेक्स्ट.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.

---

setWrapText(wrapText)

सेट करता है कि वैल्यू टेक्स्ट, एक लाइन में दिखाया जाए या कई लाइनों में.

पैरामीटर

नाम	टाइप	ब्यौरा
wrapText	Boolean	अगर true हो, तो टेक्स्ट को रैप करके एक से ज़्यादा लाइनों में दिखाया जाता है. ऐसा न होने पर, टेक्स्ट को छोटा कर दिया जाता है.

रिटर्न

DecoratedText — यह ऑब्जेक्ट, चेन बनाने के लिए है.