Class Grid

ग्रिड

ग्रिड आइटम के कलेक्शन को दिखाने के लिए व्यवस्थित ग्रिड.

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

var grid = CardService.newGrid()
    .setTitle("My Grid")
    .setNumColumns(2)
    .addItem(CardService.newGridItem()
        .setTitle("My item"));

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
addItem(gridItem)	Grid	ग्रिड में एक नया ग्रिड आइटम जोड़ता है.
setAuthorizationAction(action)	Grid	अनुमति देने से जुड़ी ऐसी कार्रवाई सेट करता है जो ऑब्जेक्ट के क्लिक किया गया.
setBorderStyle(borderStyle)	Grid	हर ग्रिड आइटम पर लागू की गई बॉर्डर शैली सेट करता है.
setComposeAction(action, composedEmailType)	Grid	ऐसी कार्रवाई सेट करता है जो ऑब्जेक्ट पर क्लिक किए जाने पर, ड्राफ़्ट ईमेल बनाती है.
setNumColumns(numColumns)	Grid	ग्रिड में दिखाए जाने वाले कॉलम की संख्या.
setOnClickAction(action)	Grid	ऐसी कार्रवाई सेट करता है जो ऑब्जेक्ट पर क्लिक किए जाने पर चलती है.
setOnClickOpenLinkAction(action)	Grid	ऐसी कार्रवाई सेट करता है जिससे ऑब्जेक्ट पर क्लिक किए जाने पर, टैब में यूआरएल खुलता है.
setOpenLink(openLink)	Grid	यह नीति, ऑब्जेक्ट पर क्लिक होने पर खुलने वाला यूआरएल सेट करती है.
setTitle(title)	Grid	ग्रिड का टाइटल टेक्स्ट सेट करता है.

विस्तृत दस्तावेज़

addItem(gridItem)

ग्रिड में एक नया ग्रिड आइटम जोड़ता है.

पैरामीटर

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

वापसी का टिकट

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

---

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

वापसी का टिकट

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

---

setBorderStyle(borderStyle)

हर ग्रिड आइटम पर लागू की गई बॉर्डर शैली सेट करता है. डिफ़ॉल्ट NO_BORDER है.

पैरामीटर

नाम	टाइप	ब्यौरा
borderStyle	BorderStyle	लागू की जाने वाली बॉर्डर शैली.

वापसी का टिकट

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

---

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

वापसी का टिकट

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

---

setNumColumns(numColumns)

ग्रिड में दिखाए जाने वाले कॉलम की संख्या. अगर दाईं ओर मौजूद पैनल में यह दिखता है, तो 1-2 कॉलम और डिफ़ॉल्ट वैल्यू 1 है. अगर किसी डायलॉग बॉक्स में दिखाया जाता है, तो दो-तीन कॉलम दिखाए जा सकते हैं और डिफ़ॉल्ट वैल्यू 2 है.

पैरामीटर

नाम	टाइप	ब्यौरा
numColumns	Integer	कॉलम की संख्या.

वापसी का टिकट

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

---

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

वापसी का टिकट

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

---

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

वापसी का टिकट

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

---

setOpenLink(openLink)

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

पैरामीटर

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

वापसी का टिकट

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

---

setTitle(title)

ग्रिड का टाइटल टेक्स्ट सेट करता है. टेक्स्ट, बिना फ़ॉर्मैट वाला एक सादा स्ट्रिंग होना चाहिए.

पैरामीटर

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

वापसी का टिकट

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