इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class Image

एक इमेज दिखाने वाला विजेट. इमेज काटने के बारे में जानकारी के लिए, ImageCropStyle देखें.

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

const image = CardService.newImage()
                  .setAltText('A nice image')
                  .setImageUrl('https://image.png');

तरीके

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

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

`setAltText(altText)`

सुलभता के लिए, इमेज का वैकल्पिक टेक्स्ट सेट करता है. ज़रूरी है.

पैरामीटर

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

वापसी का टिकट

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

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

वापसी का टिकट

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

`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() {
  const thread = GmailApp.getThreadById(e.threadId);
  const draft = thread.createDraftReply('This is a reply');
  return CardService.newComposeActionResponseBuilder()
      .setGmailDraft(draft)
      .build();
}

पैरामीटर

नाम	टाइप	ब्यौरा
`action`	`Action`	यह ऑब्जेक्ट, इस एलिमेंट पर क्लिक करने पर, लिखने की कार्रवाई के बारे में बताता है.
`composedEmailType`	`ComposedEmailType`	एक ईनम वैल्यू, जो यह बताती है कि बनाया गया ड्राफ़्ट, स्टैंडअलोन है या जवाब का ड्राफ़्ट.

वापसी का टिकट

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

`setImageUrl(url)`

इसका इस्तेमाल करके, इमेज का यूआरएल या डेटा स्ट्रिंग दी जा सकती है. ज़रूरी है.

दिया गया यूआरएल, सार्वजनिक तौर पर ऐक्सेस किया जा सकने वाला यूआरएल या base64 में एन्कोड की गई इमेज स्ट्रिंग हो सकती है. बाद वाली वैल्यू पाने के लिए, नीचे दिए गए कोड का इस्तेमाल करके, अपने Google Drive में मौजूद किसी इमेज से कोड की गई इमेज स्ट्रिंग बनाएं. इसके बाद, उस स्ट्रिंग को setImageUrl(url) के साथ बाद में इस्तेमाल करने के लिए सेव करें. इस तरीके से, आपके ऐड-ऑन को सार्वजनिक तौर पर उपलब्ध इमेज का यूआरएल ऐक्सेस करने की ज़रूरत नहीं पड़ती:

// The following assumes you have the image to use in Google Drive and have its
// ID.
const imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes();
const encodedImageURL =
    `data:image/jpeg;base64,${Utilities.base64Encode(imageBytes)}`;

// You can store encodeImageURL and use it as a parameter to
// Image.setImageUrl(url).

पैरामीटर

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

वापसी का टिकट

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

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

वापसी का टिकट

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

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

वापसी का टिकट

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

`setOpenLink(openLink)`

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

पैरामीटर

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

वापसी का टिकट

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