Class KeyValue

মূলমান

অপ্রচলিত। এই ক্লাসটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

এই ক্লাসটি অপ্রচলিত। এর পরিবর্তে DecoratedText ব্যবহার করুন।

পদ্ধতি

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

অপ্রচলিত পদ্ধতি

পদ্ধতি	রিটার্ন টাইপ	সংক্ষিপ্ত বিবরণ
set Bottom Label(text)	Key Value	কী (key) হিসেবে ব্যবহৃত হওয়ার জন্য লেবেল টেক্সট নির্ধারণ করে।
set Button(button)	Key Value	কন্টেক্সটের ডানদিকে প্রদর্শিত Button নির্ধারণ করে।
set Content(text)	Key Value	মান হিসেবে ব্যবহৃত হওয়ার জন্য টেক্সট নির্ধারণ করে।
set Icon(icon)	Key Value	কী হিসেবে ব্যবহার করার জন্য আইকনটি নির্ধারণ করে।
set Icon Alt Text(altText)	Key Value	আইকনের জন্য বিকল্প টেক্সট নির্ধারণ করে।
set Icon Url(url)	Key Value	কী (key) হিসেবে ব্যবহৃত হওয়ার জন্য আইকনের ইউআরএল (URL) নির্ধারণ করে।
set Multiline(multiline)	Key Value	মান টেক্সটটি এক লাইনে নাকি একাধিক লাইনে প্রদর্শিত হবে তা নির্ধারণ করে।
set Switch(switchToSet)	Key Value	কন্টেন্টের ডানদিকে প্রদর্শিত Switch সেট করে।
set Top Label(text)	Key Value	কী (key) হিসেবে ব্যবহৃত হওয়ার জন্য লেবেল টেক্সট নির্ধারণ করে।

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

addEventAction(eventAction)

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

প্যারামিটার

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

ফেরত

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

---

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	এই এলিমেন্টটি ক্লিক করা হলে যে অনুমোদনমূলক পদক্ষেপটি গ্রহণ করা হবে, তা এই অবজেক্টটি নির্দিষ্ট করে।

ফেরত

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

---

setComposeAction(action, composedEmailType)

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

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

দ্রষ্টব্য : এই পদ্ধতিটি এমন কোনো কম্পোজ অ্যাকশন সেট করে না যা কম্পোজ UI-কে প্রসারিত করতে ব্যবহৃত হয়। বরং, এই পদ্ধতিটি এই UI এলিমেন্টটিকে এমন একটি Action সাথে সংযুক্ত করে, যা অ্যাপস স্ক্রিপ্টে খসড়া বার্তা তৈরি করে এবং অ্যাকশনটি সম্পন্ন হলে সেই বার্তাগুলো জিমেইলে খোলা হয়।

// ...

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	একটি এনুম ভ্যালু যা নির্দিষ্ট করে যে রচিত খসড়াটি একটি স্বতন্ত্র খসড়া নাকি প্রত্যুত্তর খসড়া।

ফেরত

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

---

setId(id)

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

প্যারামিটার

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

ফেরত

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

---

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	এই এলিমেন্টটিতে ক্লিক করা হলে যে পদক্ষেপটি নিতে হবে।

ফেরত

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

---

setOnClickOpenLinkAction(action)

অবজেক্টটিতে ক্লিক করা হলে একটি ট্যাবে URL খোলার জন্য একটি অ্যাকশন সেট করে। যখন URL তৈরি করার প্রয়োজন হয় অথবা OpenLink অবজেক্ট তৈরি করার পাশাপাশি অন্য কোনো কাজ করার প্রয়োজন হয়, তখন এই ফাংশনটি ব্যবহার করুন। একটি UI অবজেক্টে setOpenLink(openLink) , setOnClickAction(action) , setOnClickOpenLinkAction(action), setAuthorizationAction(action) setOnClickOpenLinkAction(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	এই এলিমেন্টটি ক্লিক করা হলে কোন ওপেন লিঙ্ক অ্যাকশনটি গ্রহণ করা হবে, তা এই অবজেক্টটি নির্দিষ্ট করে।

ফেরত

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

---

setOpenLink(openLink)

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

প্যারামিটার

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

ফেরত

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

---

setVisibility(visibility)

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

প্যারামিটার

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

ফেরত

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

অপ্রচলিত পদ্ধতি

setBottomLabel(text)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

লেবেল টেক্সটকে কী (key) হিসেবে ব্যবহারের জন্য সেট করে। এটি টেক্সট-কন্টেন্টের নিচে প্রদর্শিত হয়।

প্যারামিটার

নাম	প্রকার	বর্ণনা
text	String	লেবেলের লেখা। দ্রষ্টব্য: এটি সাধারণ HTML ফরম্যাটিং সমর্থন করে না।

ফেরত

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

---

setButton(button)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

কন্টেক্সটের ডানদিকে প্রদর্শিত Button নির্ধারণ করে। একটি KeyValue শুধুমাত্র একটি বাটন, একটি সুইচ বা একটি আইকন সমর্থন করতে পারে।

প্যারামিটার

নাম	প্রকার	বর্ণনা
button	Button	যোগ করার বাটনটি।

ফেরত

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

---

setContent(text)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

মান হিসেবে ব্যবহৃত হওয়ার জন্য টেক্সট নির্ধারণ করে। সাধারণ HTML ফরম্যাটিং সমর্থন করে। আবশ্যক।

প্যারামিটার

নাম	প্রকার	বর্ণনা
text	String	এই উইজেটের পাঠ্য বিষয়বস্তু।

ফেরত

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

---

setIcon(icon)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

কী হিসেবে ব্যবহার করার জন্য আইকনটি নির্ধারণ করে।

প্যারামিটার

নাম	প্রকার	বর্ণনা
icon	Icon	পূর্বনির্ধারিত Icon মানগুলোর মধ্যে একটি।

ফেরত

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

---

setIconAltText(altText)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

আইকনের জন্য বিকল্প টেক্সট নির্ধারণ করে।

প্যারামিটার

নাম	প্রকার	বর্ণনা
alt Text	String	আইকনটির বিকল্প লেখা।

ফেরত

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

---

setIconUrl(url)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

কী (key) হিসেবে ব্যবহৃত হওয়ার জন্য আইকনের ইউআরএল (URL) নির্ধারণ করে।

প্যারামিটার

নাম	প্রকার	বর্ণনা
url	String	আইকন হিসেবে ব্যবহার করার জন্য হোস্ট করা ছবির ইউআরএল ঠিকানা।

ফেরত

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

---

setMultiline(multiline)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

মান টেক্সটটি এক লাইনে নাকি একাধিক লাইনে প্রদর্শিত হবে তা নির্ধারণ করে।

প্যারামিটার

নাম	প্রকার	বর্ণনা
multiline	Boolean	মাল্টিলাইন সেটিং।

ফেরত

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

---

setSwitch(switchToSet)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

কন্টেন্টের ডানদিকে প্রদর্শিত Switch নির্ধারণ করে। একটি KeyValue শুধুমাত্র একটি বাটন, একটি সুইচ অথবা একটি আইকন সমর্থন করতে পারে।

প্যারামিটার

নাম	প্রকার	বর্ণনা
switch To Set	Switch	যোগ করার জন্য সুইচটি।

ফেরত

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

---

setTopLabel(text)

অপ্রচলিত। এই ফাংশনটি অপ্রচলিত এবং নতুন স্ক্রিপ্টে ব্যবহার করা উচিত নয়।

লেবেল টেক্সটকে কী (key) হিসেবে ব্যবহারের জন্য সেট করে। এটি টেক্সট-কন্টেন্টের উপরে প্রদর্শিত হয়।

প্যারামিটার

নাম	প্রকার	বর্ণনা
text	String	লেবেলের লেখা। দ্রষ্টব্য: এটি সাধারণ HTML ফরম্যাটিং সমর্থন করে না।

ফেরত

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