Class KeyValue

KeyValue

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

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

तरीके

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

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

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

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

addEventAction(eventAction)

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

पैरामीटर

नाम	टाइप	ब्यौरा
eventAction	EventAction	जोड़ने के लिए 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);

पैरामीटर

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

वापसी का टिकट

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

---

setComposeAction(action, composedEmailType)

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

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

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

वापसी का टिकट

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

---

setId(id)

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

पैरामीटर

नाम	टाइप	ब्यौरा
id	String	यह विजेट का आईडी होता है. इसमें ज़्यादा से ज़्यादा 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();
}

पैरामीटर

नाम	टाइप	ब्यौरा
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 — यह ऑब्जेक्ट, चेनिंग के लिए है.

---

setVisibility(visibility)

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

पैरामीटर

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

वापसी का टिकट

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

ऐसे तरीके जिन्हें अब इस्तेमाल नहीं किया जा सकता

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