ব্যবহারকারী যখন ক্যালেন্ডার এবং ক্যালেন্ডার ইভেন্টগুলি দেখছেন বা এডিট করছেন তখন Google Workspace অ্যাড-অনগুলি কাস্টমাইজ করা ইন্টারফেস প্রদান করতে পারে। এটি আপনাকে ব্যবহারকারীকে অতিরিক্ত প্রাসঙ্গিক তথ্য প্রদান করতে, কাজগুলি স্বয়ংক্রিয় করতে এবং তৃতীয় পক্ষের সিস্টেমগুলিকে Google ক্যালেন্ডারে সংযুক্ত করতে দেয়৷
Google ক্যালেন্ডারের জন্য একটি অ্যাড-অন ইন্টারফেস তৈরি করার সময়, আপনি একটি হোমপেজ প্রদান করতে পারেন। আপনি একাধিক হোস্টের জন্য একই হোমপেজ ব্যবহার করতে পারেন বা Google ক্যালেন্ডারের জন্য একটি নির্দিষ্ট ডিজাইন করতে পারেন।
আপনার অ্যাড-অন এমন একটি ইন্টারফেসও সংজ্ঞায়িত করতে পারে যা ব্যবহারকারীর একটি ক্যালেন্ডার ইভেন্ট খোলা থাকলে প্রদর্শিত হয়।
অ্যাড-অন UI অ্যাক্সেস করা হচ্ছে
এটি কীভাবে খোলা হয়েছে তার উপর নির্ভর করে, একটি Google Workspace অ্যাড-অন একটি হোমপেজ ইন্টারফেস, একটি Google ক্যালেন্ডার ইভেন্ট ইন্টারফেস, একটি সংযুক্তি নির্বাচন ইন্টারফেস বা তিনটি সংজ্ঞায়িত করতে পারে:
- একজন ব্যবহারকারী ক্যালেন্ডার ভিউতে থাকাকালীন অ্যাড-অন আইকনে ক্লিক করলে, অ্যাড-অনটি সংশ্লিষ্ট
calendar.homepageTriggerফাংশনটি চালায় (যদি উপস্থিত থাকে)। এই ফাংশনটি প্রদর্শনের জন্য ক্যালেন্ডারে একটি হোমপেজ কার্ড তৈরি করে এবং ফেরত দেয়। যদি কোনোcalendar.homepageTriggerফাংশন সংজ্ঞায়িত করা না থাকে, তাহলে এর পরিবর্তে একটি জেনেরিক হোমপেজ কার্ড প্রদর্শিত হয়। - যদি ব্যবহারকারী একটি ক্যালেন্ডার ইভেন্ট খোলে এবং তারপর অ্যাড-অন আইকনে ক্লিক করে, অথবা ব্যবহারকারী যখন একটি ইভেন্ট খোলে অ্যাড-অনটি খোলা থাকে, তাহলে অ্যাড-অনটি সংশ্লিষ্ট
eventOpenTriggerফাংশনটি চালায় (যদি উপস্থিত থাকে)। এই ফাংশনটি অ্যাড-অনের ক্যালেন্ডার ইভেন্ট ইন্টারফেস তৈরি করে এবং প্রদর্শনের জন্য Google ক্যালেন্ডারে ফিরে আসে। - যদি অ্যাড-অন একটি
eventAttachmentTriggerফাংশনকে সংজ্ঞায়িত করে, একটি ক্যালেন্ডার ইভেন্ট সম্পাদনা করার সময় ব্যবহারকারী সংযুক্তি যোগ করুন ক্লিক করলে অ্যাড-অনটি একটি সংযুক্তি প্রদানকারী হিসাবে উপস্থিত হয়। যখন অ্যাড-অন নির্বাচন করা হয়,eventAttachmentTriggerফাংশন অ্যাড-অনের সংযুক্তি নির্বাচন ইন্টারফেস তৈরি করে এবং প্রদর্শনের জন্য এটি Google ক্যালেন্ডারে ফেরত দেয়।
অ্যাড-অন ক্যালেন্ডার ইন্টারফেস তৈরি করা হচ্ছে
আপনি এই ধাপগুলি অনুসরণ করে একটি Google Workspace অ্যাড-অন দিয়ে Google ক্যালেন্ডার প্রসারিত করতে পারেন:
- আপনি আপনার অ্যাড-অনে একটি ক্যালেন্ডার-নির্দিষ্ট হোমপেজ রাখতে চান কিনা তা নির্ধারণ করুন। ব্যবহারকারী ক্যালেন্ডার ইভেন্টগুলি সম্পাদনা করার সময় আপনি একটি কাস্টম ইন্টারফেস প্রদান করতে চান কিনা তাও সিদ্ধান্ত নিন।
- অ্যাড-অন স্ক্রিপ্ট প্রোজেক্ট ম্যানিফেস্টে উপযুক্ত
addOns.commonএবংaddOns.calendarক্ষেত্রগুলি যোগ করুন, প্রয়োজনীয় যেকোন স্কোপ সহ। - আপনি যদি একটি ক্যালেন্ডার-নির্দিষ্ট হোমপেজ প্রদান করেন, এই ইন্টারফেসটি তৈরি করতে
calendar.homepageTriggerফাংশনটি প্রয়োগ করুন। এছাড়াও আপনি একাধিক Google Workspace হোস্টের জন্যcommon.homepageTriggerইন্টারফেস ব্যবহার করতে পারেন। - আপনি যদি একটি ক্যালেন্ডার ইভেন্ট ইন্টারফেস প্রদান করেন, তাহলে এই ইন্টারফেসটি তৈরি করতে আপনাকে অবশ্যই একটি
calendar.eventOpenTriggerফাংশন প্রয়োগ করতে হবে। বিস্তারিত জানার জন্য ক্যালেন্ডার ইভেন্ট ইন্টারফেস প্রসারিত করা দেখুন। - ব্যবহারকারীর UI ইন্টারঅ্যাকশনগুলিতে প্রতিক্রিয়া জানাতে প্রয়োজনীয় সংশ্লিষ্ট কলব্যাক ফাংশনগুলি প্রয়োগ করুন, যেমন বোতাম ক্লিক৷
ক্যালেন্ডার হোমপেজ
Google Calendar Google Workspace অ্যাড-অন হোমপেজ দেখানো সমর্থন করে। Google ক্যালেন্ডারে আপনার অ্যাড-অনের সাধারণ হোমপেজ দেখানোর জন্য, অ্যাড-অনের ম্যানিফেস্টে একটি addOns.calendar ক্ষেত্র আছে তা নিশ্চিত করুন।
বিকল্পভাবে, একটি ক্যালেন্ডার-নির্দিষ্ট হোমপেজ প্রদান করতে অ্যাড-অন ম্যানিফেস্টে একটি calendar.homepageTrigger যোগ করুন।
উভয় ক্ষেত্রেই, আপনাকে আপনার অ্যাড-অনের স্ক্রিপ্ট প্রকল্পে একটি হোমপেজ ট্রিগার ফাংশনের নাম প্রদান করতে হবে। যখন প্রয়োজন হয় তখন এই ফাংশনটিকে স্বয়ংক্রিয়ভাবে Google ক্যালেন্ডারের হোমপেজ তৈরি করতে বলা হয়। হোমপেজ তৈরি করে এমন একটি Card বা Card অবজেক্টের একটি অ্যারে তৈরি করতে এবং ফেরত দিতে আপনাকে অবশ্যই এই ফাংশনটি বাস্তবায়ন করতে হবে। হোমপেজ ট্রিগার ফাংশনটি একটি ইভেন্ট অবজেক্টকে একটি প্যারামিটার হিসাবে পাস করা হয় যাতে ক্লায়েন্টের প্ল্যাটফর্মের মতো কিছু সাধারণ তথ্য থাকে। হোমপেজ নির্মাণের জন্য আপনি ইভেন্ট অবজেক্ট ডেটা ব্যবহার করতে পারেন।
ক্যালেন্ডার ইভেন্ট ইন্টারফেস প্রসারিত করা হচ্ছে
ব্যবহারকারী যখন একটি ক্যালেন্ডার ইভেন্ট সম্পাদনা করে তখন কোন ইন্টারফেস (যদি থাকে) প্রদর্শন করতে হবে তা নির্ধারণ করতে Google ক্যালেন্ডার একটি প্রাসঙ্গিক ট্রিগারের উপর নির্ভর করে। যখন ট্রিগার ফায়ার হয়, তখন এটি অ্যাড-অন ম্যানিফেস্টে calendar.eventOpenTrigger ফিল্ড দ্বারা নির্দিষ্ট করা প্রাসঙ্গিক ট্রিগার ফাংশন চালায়।
আপনি calendar.eventOpenTrigger ক্ষেত্রের নামের ফাংশন বাস্তবায়ন করতে হবে। এই ফাংশনটি একটি ইভেন্ট অবজেক্টকে একটি যুক্তি হিসাবে গ্রহণ করে এবং ব্যবহারকারীর ইভেন্ট খোলা থাকা অবস্থায় ক্যালেন্ডারের জন্য একটি একক Card অবজেক্ট বা Card অবজেক্টের একটি অ্যারে ফেরত দিতে হবে।
ঘটনা বস্তু
একটি ইভেন্ট অবজেক্ট তৈরি করা হয় এবং calendar.eventOpenTrigger প্রাসঙ্গিক ট্রিগার ফাংশনে পাঠানো হয় যখন একজন ব্যবহারকারী একটি ক্যালেন্ডার ইভেন্ট খোলে। ট্রিগার ফাংশন এই ইভেন্ট অবজেক্টের তথ্য ব্যবহার করে কিভাবে অ্যাড-অন কার্ড তৈরি করতে হয় বা অ্যাড-অন আচরণ নিয়ন্ত্রণ করতে পারে। ইভেন্ট অবজেক্টগুলিও তৈরি করা হয় এবং homepageTrigger ফাংশনে প্রেরণ করা হয় যখন একটি অ্যাড-অন প্রথম খোলা হয় এবং যখন ব্যবহারকারী ইন্টারেক্টিভ উইজেটগুলি ক্লিক করে বা নির্বাচন করে।
ইভেন্ট অবজেক্টের সম্পূর্ণ গঠন ইভেন্ট অবজেক্টে বর্ণনা করা হয়েছে। যখন ক্যালেন্ডার অ্যাড-অনের অভিনয় হোস্ট অ্যাপ, প্রাসঙ্গিক ট্রিগার এবং উইজেট ইন্টারঅ্যাকশন ইভেন্ট অবজেক্টে ক্যালেন্ডার ইভেন্ট অবজেক্ট ক্ষেত্র অন্তর্ভুক্ত থাকে যা ক্যালেন্ডার-নির্দিষ্ট ক্লায়েন্ট তথ্য বহন করে।
ক্যালেন্ডার ইভেন্ট আপডেট করা হচ্ছে
প্রাসঙ্গিক calendar.eventOpenTrigger ছাড়াও যেটি ফায়ার হয় যখন একজন ব্যবহারকারী সম্পাদনার জন্য একটি ক্যালেন্ডার ইভেন্ট খোলে, আপনি একটি calendar.eventUpdateTrigger সংজ্ঞায়িত করতে পারেন যা ব্যবহারকারী যখন একটি ক্যালেন্ডার ইভেন্ট আপডেট করে এবং সংরক্ষণ করে তখন ফায়ার হয়৷ এই ট্রিগারটি শুধুমাত্র তখনই ফায়ার হয় যখন ব্যবহারকারী নিম্নলিখিতগুলির মধ্যে এক বা একাধিক সম্পাদনা করেন:
- এক বা একাধিক অংশগ্রহণকারী যোগ করে।
- এক বা একাধিক অংশগ্রহণকারীদের সরিয়ে দেয়।
- একটি ভিন্ন কনফারেন্সিং সমাধান যোগ করে বা সুইচ করে।
যখন এই ট্রিগারটি ফায়ার হয়, তখন এটি calendar.eventUpdateTrigger ম্যানিফেস্ট ফিল্ড দ্বারা নির্দিষ্ট করা ট্রিগার ফাংশনটি চালায়। ক্যালেন্ডার ইভেন্ট সম্পাদনা সংরক্ষিত হওয়ার আগে ফাংশনটি কার্যকর করা হয়।
calendar.eventUpdateTrigger সাধারণত নিম্নলিখিত এক বা একাধিক করতে ব্যবহৃত হয়:
- ক্যালেন্ডার ইভেন্টে ব্যবহারকারীর পরিবর্তনের প্রতিক্রিয়া হিসাবে অ্যাড-অনের ক্যালেন্ডার ইভেন্ট ইন্টারফেস আপডেট করুন।
- একটি তৃতীয় পক্ষের সিস্টেমের সাথে ক্যালেন্ডার ইভেন্ট ডেটা সিঙ্ক করুন, যেমন একটি কনফারেন্সিং সিস্টেম যা Google ক্যালেন্ডারের সাথে সংযুক্ত।
একটি ক্যালেন্ডার ইভেন্টের ডেটা (যেমন এর অংশগ্রহণকারীদের তালিকার মতো) সামঞ্জস্য করতে আপনার অ্যাড-অনের প্রয়োজন হলে, আপনাকে অবশ্যই অ্যাড-অন calendar.currentEventAccess ম্যানিফেস্ট ফিল্ডটি WRITE বা READ_WRITE এ সেট করতে হবে। এর জন্য অ্যাড-অনেরও প্রয়োজন https://www.googleapis.com/auth/calendar.addons.current.event.write স্কোপ ।
কনফারেন্সিং সমাধান যোগ করা
কনফারেন্সিং সমাধানগুলি একটি তৃতীয় পক্ষের কনফারেন্স বিকল্পগুলি উপস্থাপন করে যা ব্যবহারকারীরা Google ক্যালেন্ডার ইভেন্টগুলিতে সংযুক্ত করতে পারে৷ থার্ড-পার্টি কনফারেন্সিং ওভারভিউ ডকুমেন্টেশন নতুন কনফারেন্সিং সমাধান যোগ করে এমন একটি অ্যাড-অন কীভাবে তৈরি করতে হয় তার বিশদ বিবরণ প্রদান করে। এই ধরনের এক্সটেনশনের জন্য একটি UI তৈরি করার প্রয়োজন নেই; যোগ করা সমাধানগুলি সহজভাবে Google ক্যালেন্ডার ইভেন্ট UI এর ড্রপ-ডাউন মেনুতে বিকল্প হিসাবে উপস্থিত হয়।