Class Image

ছবি

একটি উইজেট যা একটিমাত্র ছবি প্রদর্শন করে। ছবি ক্রপ করার বিষয়ে জানতে ImageCropStyle দেখুন।

গুগল ওয়ার্কস্পেস অ্যাড-অন এবং গুগল চ্যাট অ্যাপের জন্য উপলব্ধ।

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

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Event Action(eventAction) Widget উইজেটটিতে সম্পাদনযোগ্য ইভেন্ট অ্যাকশনটি যোগ করে।
set Alt Text(altText) Image অ্যাক্সেসিবিলিটির জন্য ছবিটির বিকল্প টেক্সট সেট করে।
set Authorization Action(action) Image একটি অনুমোদন অ্যাকশন সেট করে, যা অবজেক্টটিতে ক্লিক করা হলে অনুমোদন ফ্লো-এর জন্য একটি URL খুলে দেয়।
set Compose Action(action, composedEmailType) Image অবজেক্টটিতে ক্লিক করা হলে একটি খসড়া ইমেল তৈরি করার অ্যাকশন সেট করে।
set Id(id) Widget যে উইজেটটি পরিবর্তন করা হবে, সেটিকে শনাক্ত করার জন্য নির্ধারিত অনন্য আইডি সেট করে।
set Image Url(url) Image এর ইউআরএল বা ডেটা স্ট্রিং প্রদান করে ব্যবহারের জন্য ছবিটি নির্ধারণ করা হয়।
set On Click Action(action) Image অবজেক্টটিতে ক্লিক করা হলে যে অ্যাকশনটি কার্যকর হবে, তা নির্ধারণ করে।
set On Click Open Link Action(action) Image অবজেক্টটিতে ক্লিক করা হলে একটি ট্যাবে ইউআরএল খোলার অ্যাকশন সেট করে।
set Open Link(openLink) Image অবজেক্টটিতে ক্লিক করা হলে যে URL-টি খোলা হবে, তা নির্ধারণ করে।
set Visibility(visibility) Widget উইজেটটির দৃশ্যমানতা নির্ধারণ করে।

বিস্তারিত ডকুমেন্টেশন

addEventAction(eventAction)

উইজেটটিতে সম্পাদনযোগ্য ইভেন্ট অ্যাকশনটি যোগ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
event Action Event Action Event Action যোগ করা হবে।

ফেরত

Widget — শৃঙ্খলিত করার জন্য ব্যবহৃত অবজেক্ট।

setAltText(altText)

অ্যাক্সেসিবিলিটির জন্য ছবির বিকল্প টেক্সট সেট করে। আবশ্যক।

প্যারামিটার

নাম প্রকার বর্ণনা
alt Text String এই ছবিতে বরাদ্দ করার জন্য বিকল্প লেখা।

ফেরত

Image — এই অবজেক্টটি, চেইন করার জন্য।

setAuthorizationAction(action)

একটি অনুমোদন অ্যাকশন সেট করে, যা অবজেক্টটিতে ক্লিক করা হলে অনুমোদন ফ্লো-এর জন্য একটি URL খোলে। এটি একটি নতুন উইন্ডোতে URL-টি খোলে। যখন ব্যবহারকারী অনুমোদন ফ্লো শেষ করে অ্যাপ্লিকেশনে ফিরে আসেন, তখন অ্যাড-অনটি রিলোড হয়।

একটি UI অবজেক্টে setOpenLink(openLink) , setOnClickAction(action) , setOnClickOpenLinkAction(action) , setAuthorizationAction(action) , অথবা setComposeAction(action, composedEmailType) এর মধ্যে শুধুমাত্র একটি সেট করা থাকতে পারে।

// ...

const action = CardService.newAuthorizationAction().setAuthorizationUrl('url');
CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);

প্যারামিটার

নাম প্রকার বর্ণনা
action Authorization Action এই এলিমেন্টটি ক্লিক করা হলে যে অনুমোদনমূলক পদক্ষেপটি গ্রহণ করা হবে, তা এই অবজেক্টটি নির্দিষ্ট করে।

ফেরত

Image — এই অবজেক্টটি, চেইন করার জন্য।

setComposeAction(action, composedEmailType)

অবজেক্টটিতে ক্লিক করা হলে একটি খসড়া ইমেল তৈরি করার জন্য একটি অ্যাকশন সেট করে। একটি UI অবজেক্টে setOpenLink(openLink) , setOnClickAction(action) , setOnClickOpenLinkAction(action) , setAuthorizationAction(action) , অথবা setComposeAction(action, composedEmailType) - এই বিকল্পগুলোর মধ্যে শুধুমাত্র একটি সেট করা থাকতে পারে।

Action প্যারামিটারে অবশ্যই একটি কলব্যাক ফাংশন নির্দিষ্ট করতে হবে, যা ComposeActionResponseBuilder.setGmailDraft(draft) ব্যবহার করে কনফিগার করা একটি ComposeActionResponse অবজেক্ট রিটার্ন করে।

// ...

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 এই এলিমেন্টটি ক্লিক করা হলে যে কম্পোজ অ্যাকশনটি গ্রহণ করা হবে, তা এই অবজেক্টটি নির্দিষ্ট করে।
composed Email Type Composed Email Type একটি এনুম ভ্যালু যা নির্দিষ্ট করে যে রচিত খসড়াটি একটি স্বতন্ত্র খসড়া নাকি প্রত্যুত্তর খসড়া।

ফেরত

Image — এই অবজেক্টটি, চেইন করার জন্য।

setId(id)

যে উইজেটটি পরিবর্তন করা হবে, সেটিকে শনাক্ত করার জন্য একটি অনন্য আইডি নির্ধারণ করে। উইজেট পরিবর্তন শুধুমাত্র অ্যাড-অন-এ সমর্থিত।

প্যারামিটার

নাম প্রকার বর্ণনা
id String উইজেটের আইডি, যা সর্বোচ্চ ৬৪ অক্ষরের হতে হবে এবং এর ফরম্যাট হবে `[a-zA-Z0-9-]+`।

ফেরত

Widget — এই অবজেক্টটি, চেইন করার জন্য ব্যবহৃত হয়।

setImageUrl(url)

URL অথবা ডেটা স্ট্রিং প্রদান করে ব্যবহারের জন্য ছবিটি সেট করা হয়। আবশ্যক।

প্রদত্ত URL-টি একটি সর্বজনীনভাবে অ্যাক্সেসযোগ্য URL অথবা একটি base64 এনকোডেড ইমেজ স্ট্রিং হতে পারে। পরেরটি পেতে, আপনি আপনার Google Drive-এর কোনো ছবি থেকে একটি এনকোডেড ইমেজ স্ট্রিং তৈরি করার জন্য নিম্নলিখিত কোডটি ব্যবহার করতে পারেন, এবং তারপর setImageUrl(url) ব্যবহার করে পরবর্তী ব্যবহারের জন্য সেই স্ট্রিংটি সংরক্ষণ করতে পারেন। এই পদ্ধতিটি আপনার অ্যাড-অনকে সর্বজনীনভাবে উপলব্ধ কোনো ইমেজ URL অ্যাক্সেস করার প্রয়োজনীয়তা থেকে বিরত রাখে:

// The following assumes you have the image to use in Google Drive and have its
// ID.
const imageBytes = DriveApp.getFileById('123abc').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)

অবজেক্টটি ক্লিক করা হলে যে অ্যাকশনটি কার্যকর হবে তা নির্ধারণ করে। একটি UI অবজেক্টে 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)

অবজেক্টটিতে ক্লিক করা হলে একটি ট্যাবে URL খোলার জন্য একটি অ্যাকশন সেট করে। যখন URL তৈরি করার প্রয়োজন হয় অথবা OpenLink অবজেক্ট তৈরি করার পাশাপাশি অন্য কোনো কাজ করার প্রয়োজন হয়, তখন এই ফাংশনটি ব্যবহার করুন। একটি UI অবজেক্টে 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 — এই অবজেক্টটি, চেইন করার জন্য।

অবজেক্টটিতে ক্লিক করা হলে যে URL-টি খোলা হবে, তা সেট করে। যখন URL-টি আগে থেকেই জানা থাকে এবং শুধু খোলার প্রয়োজন হয়, তখন এই ফাংশনটি ব্যবহার করুন। একটি UI অবজেক্টে setOpenLink(openLink) , setOnClickAction(action) , setOnClickOpenLinkAction(action) , setAuthorizationAction(action) , অথবা setComposeAction(action, composedEmailType) -এর মধ্যে শুধুমাত্র একটি সেট করা থাকতে পারে।

প্যারামিটার

নাম প্রকার বর্ণনা
open Link Open Link একটি Open Link অবজেক্ট, যা খোলার জন্য URL-টি বর্ণনা করে।

ফেরত

Image — এই অবজেক্টটি, চেইন করার জন্য।

setVisibility(visibility)

উইজেটটির দৃশ্যমানতা নির্ধারণ করে। এর ডিফল্ট মান হলো `VISIBLE`।

প্যারামিটার

নাম প্রকার বর্ণনা
visibility Visibility উইজেটটির Visibility ।

ফেরত

Widget — শৃঙ্খলিত করার জন্য ব্যবহৃত অবজেক্ট।