एक इमेज दिखाने वाला विजेट. इमेज को काटने के बारे में ज़्यादा जानने के लिए, ImageCropStyle
देखें.
यह सुविधा, Google Workspace ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.
var 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)
में से सिर्फ़ एक सेट हो सकता है.
// ... var 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
ऑब्जेक्ट दिखाता है.
// ... 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 | इनम वैल्यू, जिससे यह पता चलता है कि बनाया गया ड्राफ़्ट, स्टैंडअलोन ड्राफ़्ट है या जवाब का ड्राफ़्ट. |
रिटर्न
Image
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setImageUrl(url)
इमेज का यूआरएल या डेटा स्ट्रिंग देकर, इस्तेमाल करने के लिए इमेज सेट करता है. ज़रूरी है.
दिया गया यूआरएल, सार्वजनिक रूप से ऐक्सेस किया जा सकने वाला यूआरएल या base64 कोड में बदली गई इमेज स्ट्रिंग हो सकता है.
बाद वाला कोड पाने के लिए, नीचे दिए गए कोड का इस्तेमाल करके अपनी Google Drive में किसी इमेज से कोड में बदली गई इमेज स्ट्रिंग बनाई जा सकती है. इसके बाद, उस स्ट्रिंग को setImageUrl(url)
के साथ इस्तेमाल करने के लिए सेव किया जा सकता है. इस तरीके से, आपके ऐड-ऑन को सार्वजनिक तौर पर उपलब्ध इमेज के यूआरएल को ऐक्सेस करने की ज़रूरत नहीं होगी:
// The following assumes you have the image to use in Google Drive and have its ID. var imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes(); var 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
ऑब्जेक्ट दिखाता है.
// ... 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 | इस एलिमेंट पर क्लिक करने पर की जाने वाली कार्रवाई. |
रिटर्न
Image
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
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 | वह ऑब्जेक्ट जो इस एलिमेंट पर क्लिक होने के बाद की जाने वाली ओपन लिंक कार्रवाई के बारे में बताता है. |
रिटर्न
Image
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setOpenLink(openLink)
ऑब्जेक्ट के क्लिक होने पर खुलने वाला यूआरएल सेट करता है. इस फ़ंक्शन का इस्तेमाल तब करें, जब यूआरएल के बारे में
पहले से जानकारी हो और उसे सिर्फ़ खोलने की ज़रूरत हो. यूज़र इंटरफ़ेस (यूआई) ऑब्जेक्ट में setOpenLink(openLink)
,
setOnClickAction(action)
, setOnClickOpenLinkAction(action)
, setAuthorizationAction(action)
या setComposeAction(action, composedEmailType)
में से सिर्फ़ एक सेट हो सकता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
openLink | OpenLink | OpenLink ऑब्जेक्ट, जिसमें खुलने वाले यूआरएल के बारे में जानकारी दी गई है. |
रिटर्न
Image
— यह ऑब्जेक्ट, चेन बनाने के लिए है.