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)

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

पैरामीटर

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