Class KeyValue

कुंजीवैल्यू

अब काम नहीं करता. इस क्लास का इस्तेमाल बंद कर दिया गया है. इसलिए, इसे नई स्क्रिप्ट में इस्तेमाल नहीं किया जाना चाहिए.

यह क्लास अब काम नहीं करती. इसके बजाय, DecoratedText का इस्तेमाल करें.

तरीके

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

अब काम न करने वाले तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
setBottomLabel(text)	KeyValue	लेबल टेक्स्ट को सेट करता है, ताकि उसका इस्तेमाल की-वर्ड के तौर पर किया जा सके.
setButton(button)	KeyValue	संदर्भ की दाईं ओर दिखने वाले Button को सेट करता है.
setContent(text)	KeyValue	वैल्यू के तौर पर इस्तेमाल किए जाने वाले टेक्स्ट को सेट करता है.
setIcon(icon)	KeyValue	आइकॉन को बटन के तौर पर सेट करता है.
setIconAltText(altText)	KeyValue	आइकॉन के लिए वैकल्पिक टेक्स्ट सेट करता है.
setIconUrl(url)	KeyValue	इस एट्रिब्यूट की मदद से, आइकॉन का यूआरएल सेट किया जाता है. इसका इस्तेमाल, पासकोड के तौर पर किया जाता है.
setMultiline(multiline)	KeyValue	यह सेट करता है कि वैल्यू टेक्स्ट को एक लाइन में दिखाया जाए या एक से ज़्यादा लाइनों में.
setSwitch(switchToSet)	KeyValue	कॉन्टेंट की दाईं ओर दिखने वाले Switch को सेट करता है.
setTopLabel(text)	KeyValue	लेबल टेक्स्ट को सेट करता है, ताकि उसका इस्तेमाल की-वर्ड के तौर पर किया जा सके.

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

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

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setComposeAction(action, composedEmailType)

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

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

ध्यान दें: इस तरीके से, लिखने की कार्रवाई सेट नहीं होती. इसका इस्तेमाल, लिखने के यूज़र इंटरफ़ेस (यूआई) को बड़ा करने के लिए किया जाता है. इसके बजाय, यह तरीका इस यूज़र इंटरफ़ेस एलिमेंट को 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	एक सूची वाली वैल्यू, जो बताती है कि लिखा गया ड्राफ़्ट, स्टैंडअलोन है या जवाब का ड्राफ़्ट.

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

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

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

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

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setOpenLink(openLink)

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

पैरामीटर

नाम	टाइप	ब्यौरा
openLink	OpenLink	खोले जाने वाले यूआरएल की जानकारी देने वाला OpenLink ऑब्जेक्ट.

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

अब काम न करने वाले तरीके

setBottomLabel(text)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

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

पैरामीटर

नाम	टाइप	ब्यौरा
text	String	लेबल का टेक्स्ट. ध्यान दें: यह बेसिक एचटीएमएल फ़ॉर्मैटिंग के साथ काम नहीं करता.

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setButton(button)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

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

पैरामीटर

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

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setContent(text)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

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

पैरामीटर

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

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setIcon(icon)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

आइकॉन को बटन के तौर पर सेट करता है.

पैरामीटर

नाम	टाइप	ब्यौरा
icon	Icon	पहले से तय की गई Icon वैल्यू में से कोई एक.

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setIconAltText(altText)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

आइकॉन के लिए वैकल्पिक टेक्स्ट सेट करता है.

पैरामीटर

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

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setIconUrl(url)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

इस एट्रिब्यूट की मदद से, आइकॉन का यूआरएल सेट किया जाता है. इसका इस्तेमाल, पासकोड के तौर पर किया जाता है.

पैरामीटर

नाम	टाइप	ब्यौरा
url	String	होस्ट की गई इमेज का यूआरएल पता, जिसे आइकॉन के तौर पर इस्तेमाल किया जाना है.

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setMultiline(multiline)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

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

पैरामीटर

नाम	टाइप	ब्यौरा
multiline	Boolean	मल्टीलाइन सेटिंग.

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setSwitch(switchToSet)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

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

पैरामीटर

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

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.

---

setTopLabel(text)

अब काम नहीं करता. इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसलिए, नई स्क्रिप्ट में इसका इस्तेमाल नहीं किया जाना चाहिए.

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

पैरामीटर

नाम	टाइप	ब्यौरा
text	String	लेबल का टेक्स्ट. ध्यान दें: यह बेसिक एचटीएमएल फ़ॉर्मैटिंग के साथ काम नहीं करता.

वापसी का टिकट

KeyValue — चेन करने के लिए यह ऑब्जेक्ट.