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');

तरीके

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

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

addEventAction(eventAction)

विजेट पर की जा सकने वाली इवेंट कार्रवाई जोड़ता है.

पैरामीटर

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

वापसी का टिकट

Widget — यह ऑब्जेक्ट, चेनिंग के लिए होता है.


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);

पैरामीटर

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

वापसी का टिकट

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


setBottomLabel(text)

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

पैरामीटर

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

वापसी का टिकट

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


setButton(button)

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

पैरामीटर

नामटाइपब्यौरा
buttonButtonजोड़ने का बटन.

वापसी का टिकट

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


setComposeAction(action, composedEmailType)

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

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

// ...

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();
}

पैरामीटर

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

वापसी का टिकट

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


setEndIcon(endIcon)

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

पैरामीटर

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

वापसी का टिकट

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


setId(id)

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

पैरामीटर

नामटाइपब्यौरा
idStringयह विजेट का आईडी होता है. इसमें ज़्यादा से ज़्यादा 64 वर्ण हो सकते हैं. इसका फ़ॉर्मैट `[a-zA-Z0-9-]+` होता है.

वापसी का टिकट

Widget — यह ऑब्जेक्ट, चेनिंग के लिए है.


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();
}

पैरामीटर

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

वापसी का टिकट

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();
}

पैरामीटर

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

वापसी का टिकट

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


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

पैरामीटर

नामटाइपब्यौरा
openLinkOpenLinkएक OpenLink ऑब्जेक्ट, जिसमें खोलने के लिए यूआरएल की जानकारी होती है.

वापसी का टिकट

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


setStartIcon(startIcon)

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

पैरामीटर

नामटाइपब्यौरा
startIconIconImageदिखाने के लिए आइकॉन.

वापसी का टिकट

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


setSwitchControl(switchToSet)

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

पैरामीटर

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

वापसी का टिकट

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


setText(text)

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

पैरामीटर

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

वापसी का टिकट

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


setTopLabel(text)

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

पैरामीटर

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

वापसी का टिकट

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


setVisibility(visibility)

इससे विजेट के दिखने की सेटिंग सेट की जाती है. डिफ़ॉल्ट वैल्यू `VISIBLE` होती है.

पैरामीटर

नामटाइपब्यौरा
visibilityVisibilityविजेट का Visibility.

वापसी का टिकट

Widget — यह ऑब्जेक्ट, चेनिंग के लिए होता है.


setWrapText(wrapText)

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

पैरामीटर

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

वापसी का टिकट

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