Class TextButton

TextButton

टेक्स्ट लेबल वाला TextButton. ज़रूरत पड़ने पर, बैकग्राउंड का रंग सेट किया जा सकता है और बटन को बंद किया जा सकता है.

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

var textButton = CardService.newTextButton()
    .setText("Open Link")
    .setOpenLink(CardService.newOpenLink()
        .setUrl("https://www.google.com"));

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
setAltText(altText)	TextButton	सुलभता के लिए, बटन का वैकल्पिक टेक्स्ट सेट करता है.
setAuthorizationAction(action)	TextButton	अनुमति देने की कार्रवाई सेट करता है, जो ऑब्जेक्ट पर क्लिक करने पर अनुमति देने वाले फ़्लो को एक यूआरएल खोलता है.
setBackgroundColor(backgroundColor)	TextButton	TextButtonStyle.FILLED बटन के लिए बैकग्राउंड का रंग सेट करता है.
setComposeAction(action, composedEmailType)	TextButton	ऑब्जेक्ट के क्लिक होने पर, ड्राफ़्ट ईमेल बनाने वाली कार्रवाई सेट करता है.
setDisabled(disabled)	TextButton	सेट करता है कि बटन बंद है या नहीं.
setOnClickAction(action)	TextButton	ऑब्जेक्ट पर क्लिक होने पर, एक कार्रवाई सेट करता है.
setOnClickOpenLinkAction(action)	TextButton	ऑब्जेक्ट को क्लिक करने पर, टैब में यूआरएल खोलने वाली कार्रवाई सेट की जाती है.
setOpenLink(openLink)	TextButton	ऑब्जेक्ट के क्लिक होने पर खुलने वाला यूआरएल सेट करता है.
setText(text)	TextButton	बटन पर दिखने वाला टेक्स्ट सेट करता है.
setTextButtonStyle(textButtonStyle)	TextButton	बटन की स्टाइल सेट करता है.

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

setAltText(altText)

सुलभता के लिए, बटन का वैकल्पिक टेक्स्ट सेट करता है. अगर यह नीति सेट नहीं है, तो बटन पर डिफ़ॉल्ट रूप से टेक्स्ट दिखने लगता है.

पैरामीटर

नाम	टाइप	ब्यौरा
altText	String	इस बटन को असाइन करने के लिए वैकल्पिक टेक्स्ट.

रिटर्न

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

---

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	वह ऑब्जेक्ट जो इस एलिमेंट पर क्लिक होने के बाद की जाने वाली अनुमति देने की कार्रवाई तय करता है.

रिटर्न

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

---

setBackgroundColor(backgroundColor)

TextButtonStyle.FILLED बटन के लिए बैकग्राउंड का रंग सेट करता है. अगर TextButtonStyle.FILLED बटन को सेट नहीं किया जाता है, तो यह बटन ऐड-ऑन मेनिफ़ेस्ट में बताए गए दूसरे रंग का इस्तेमाल करता है. यह तरीका TextButtonStyle.OUTLINED बटन के लिए इस्तेमाल नहीं किया जा सकता.

पैरामीटर

नाम	टाइप	ब्यौरा
backgroundColor	String	आरजीबी फ़ॉर्मैट में रंग.

रिटर्न

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

---

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	इनम वैल्यू, जिससे यह पता चलता है कि बनाया गया ड्राफ़्ट, स्टैंडअलोन ड्राफ़्ट है या जवाब का ड्राफ़्ट.

रिटर्न

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

---

setDisabled(disabled)

सेट करता है कि बटन बंद है या नहीं. बंद किया गया बटन धूसर हो जाता है और उस पर क्लिक नहीं किया जा सकता.

पैरामीटर

नाम	टाइप	ब्यौरा
disabled	Boolean	बंद स्थिति.

रिटर्न

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

---

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	इस एलिमेंट पर क्लिक करने पर की जाने वाली कार्रवाई.

रिटर्न

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

---

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	वह ऑब्जेक्ट जो इस एलिमेंट पर क्लिक होने के बाद की जाने वाली ओपन लिंक कार्रवाई के बारे में बताता है.

रिटर्न

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

---

setOpenLink(openLink)

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

पैरामीटर

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

रिटर्न

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

---

setText(text)

बटन पर दिखने वाला टेक्स्ट सेट करता है.

पैरामीटर

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

रिटर्न

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

---

setTextButtonStyle(textButtonStyle)

बटन की स्टाइल सेट करता है. अगर यह नीति सेट नहीं है, तो डिफ़ॉल्ट रूप से TextButtonStyle.OUTLINED बटन दिखेगा.

पैरामीटर

नाम	टाइप	ब्यौरा
textButtonStyle	TextButtonStyle	बटन की स्टाइल.

रिटर्न

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