Class DecoratedText

DecoratedText

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

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

const decoratedText =
    CardService.newDecoratedText().setText('Text').setTopLabel('TopLabel');

const 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) में से सिर्फ़ एक सेट हो सकता है.

// ...

const 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 से जोड़ता है. यह Action, Apps Script में मैसेज का ड्राफ़्ट लिखता है. कार्रवाई पूरी होने पर, ये मैसेज Gmail में खुलते हैं.

// ...

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

// ...

function composeEmailCallback(e) {
  const thread = GmailApp.getThreadById(e.threadId);
  const 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 ऑब्जेक्ट दिखाता हो.

// ...

const 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 ऑब्जेक्ट दिखाए.

// ...

const 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 — चेन करने के लिए यह ऑब्जेक्ट.