Google ক্যালেন্ডার ইন্টারফেস তৈরি করা

ব্যবহারকারী যখন ক্যালেন্ডার এবং ক্যালেন্ডার ইভেন্ট দেখছেন বা সম্পাদনা করছেন তখন Google Workspace অ্যাড-অনগুলি কাস্টমাইজড ইন্টারফেস প্রদান করতে পারে। এটি আপনাকে ব্যবহারকারীকে অতিরিক্ত প্রাসঙ্গিক তথ্য প্রদান করতে, কাজগুলি স্বয়ংক্রিয় করতে এবং তৃতীয় পক্ষের সিস্টেমগুলিকে Google Calendar-এর সাথে সংযুক্ত করতে দেয়।

গুগল ক্যালেন্ডারের জন্য একটি অ্যাড-অন ইন্টারফেস তৈরি করার সময়, আপনি একটি হোমপেজ প্রদান করতে পারেন। আপনি একাধিক হোস্টের জন্য একই হোমপেজ ব্যবহার করতে পারেন, অথবা গুগল ক্যালেন্ডারের জন্য একটি নির্দিষ্ট ইন্টারফেস ডিজাইন করতে পারেন।

আপনার অ্যাড-অন এমন একটি ইন্টারফেসও সংজ্ঞায়িত করতে পারে যা ব্যবহারকারীর ক্যালেন্ডার ইভেন্ট খোলা থাকলে প্রদর্শিত হয়।

অ্যাড-অন UI অ্যাক্সেস করা

এটি কীভাবে খোলা হয়েছে তার উপর নির্ভর করে, একটি Google Workspace অ্যাড-অন একটি হোমপেজ ইন্টারফেস, একটি Google ক্যালেন্ডার ইভেন্ট ইন্টারফেস, একটি সংযুক্তি নির্বাচন ইন্টারফেস, অথবা তিনটিই সংজ্ঞায়িত করতে পারে:

• যদি কোনও ব্যবহারকারী ক্যালেন্ডার ভিউতে থাকাকালীন অ্যাড-অন আইকনে ক্লিক করেন, তাহলে অ্যাড-অনটি সংশ্লিষ্ট calendar.homepageTrigger ফাংশনটি কার্যকর করে (যদি থাকে)। এই ফাংশনটি প্রদর্শনের জন্য ক্যালেন্ডারে একটি হোমপেজ কার্ড তৈরি করে এবং ফেরত পাঠায়। যদি কোনও calendar.homepageTrigger ফাংশন সংজ্ঞায়িত না থাকে, তাহলে পরিবর্তে একটি জেনেরিক হোমপেজ কার্ড প্রদর্শিত হয়।
• যদি ব্যবহারকারী একটি ক্যালেন্ডার ইভেন্ট খোলে এবং তারপর অ্যাড-অন আইকনে ক্লিক করে, অথবা ব্যবহারকারী যখন একটি ইভেন্ট খোলে তখন অ্যাড-অনটি খোলা থাকে, তাহলে অ্যাড-অনটি সংশ্লিষ্ট eventOpenTrigger ফাংশনটি (যদি উপস্থিত থাকে) কার্যকর করে। এই ফাংশনটি অ্যাড-অনের ক্যালেন্ডার ইভেন্ট ইন্টারফেস তৈরি করে এবং প্রদর্শনের জন্য গুগল ক্যালেন্ডারে ফিরে আসে।
• যদি অ্যাড-অনটি একটি eventAttachmentTrigger ফাংশন সংজ্ঞায়িত করে, তাহলে ব্যবহারকারী যখন একটি ক্যালেন্ডার ইভেন্ট সম্পাদনা করার সময় "অ্যাটাচমেন্ট যোগ করুন" এ ক্লিক করেন তখন অ্যাড-অনটি একটি সংযুক্তি প্রদানকারী হিসাবে উপস্থিত হয়। যখন অ্যাড-অনটি নির্বাচন করা হয়, তখন eventAttachmentTrigger ফাংশনটি অ্যাড-অনের সংযুক্তি নির্বাচন ইন্টারফেস তৈরি করে এবং প্রদর্শনের জন্য এটি Google ক্যালেন্ডারে ফেরত পাঠায়।

অ্যাড-অন ক্যালেন্ডার ইন্টারফেস তৈরি করা

আপনি এই পদক্ষেপগুলি অনুসরণ করে Google Workspace অ্যাড-অন ব্যবহার করে Google ক্যালেন্ডার প্রসারিত করতে পারেন:

1. আপনার অ্যাড-অনটিতে একটি ক্যালেন্ডার-নির্দিষ্ট হোমপেজ থাকবে কিনা তা নির্ধারণ করুন। ব্যবহারকারী যখন ক্যালেন্ডার ইভেন্টগুলি সম্পাদনা করছেন তখন আপনি একটি কাস্টম ইন্টারফেস প্রদান করতে চান কিনা তাও নির্ধারণ করুন।
2. অ্যাড-অন স্ক্রিপ্ট প্রজেক্ট ম্যানিফেস্টে উপযুক্ত addOns.common এবং addOns.calendar ক্ষেত্রগুলি যোগ করুন, প্রয়োজনীয় যেকোনো স্কোপ সহ।
3. যদি আপনি একটি ক্যালেন্ডার-নির্দিষ্ট হোমপেজ প্রদান করেন, তাহলে এই ইন্টারফেসটি তৈরি করতে calendar.homepageTrigger ফাংশনটি প্রয়োগ করুন। আপনি একাধিক Google Workspace হোস্টের জন্য common.homepageTrigger ইন্টারফেসটি ব্যবহার করতেও পারেন।
4. যদি আপনি একটি ক্যালেন্ডার ইভেন্ট ইন্টারফেস প্রদান করেন, তাহলে এই ইন্টারফেসটি তৈরি করতে আপনাকে একটি calendar.eventOpenTrigger ফাংশন বাস্তবায়ন করতে হবে। বিস্তারিত জানার জন্য ক্যালেন্ডার ইভেন্ট ইন্টারফেস সম্প্রসারণ দেখুন।
5. ব্যবহারকারীর UI ইন্টারঅ্যাকশন, যেমন বোতাম ক্লিকের প্রতিক্রিয়া জানাতে প্রয়োজনীয় সংশ্লিষ্ট কলব্যাক ফাংশনগুলি বাস্তবায়ন করুন।

ক্যালেন্ডার হোমপেজ

গুগল ক্যালেন্ডার গুগল ওয়ার্কস্পেস অ্যাড-অন হোমপেজ প্রদর্শন সমর্থন করে। গুগল ক্যালেন্ডারে আপনার অ্যাড-অনের সাধারণ হোমপেজটি দেখানোর জন্য, অ্যাড-অনের ম্যানিফেস্টে একটি addOns.calendar ক্ষেত্র আছে কিনা তা নিশ্চিত করুন।

বিকল্পভাবে, একটি ক্যালেন্ডার-নির্দিষ্ট হোমপেজ প্রদানের জন্য অ্যাড-অন ম্যানিফেস্টে একটি calendar.homepageTrigger যোগ করুন।

যেকোনো ক্ষেত্রেই, আপনার অ্যাড-অনের স্ক্রিপ্ট প্রজেক্টে একটি হোমপেজ ট্রিগার ফাংশনের নাম অবশ্যই দিতে হবে। প্রয়োজনে এই ফাংশনটি স্বয়ংক্রিয়ভাবে গুগল ক্যালেন্ডার হোমপেজ তৈরি করতে ডাকা হয়। হোমপেজ তৈরির জন্য একটি একক Card বা Card অবজেক্টের একটি অ্যারে তৈরি এবং ফেরত দেওয়ার জন্য আপনাকে এই ফাংশনটি বাস্তবায়ন করতে হবে। হোমপেজ ট্রিগার ফাংশনটি একটি ইভেন্ট অবজেক্টকে একটি প্যারামিটার হিসাবে পাস করা হয় যাতে ক্লায়েন্টের প্ল্যাটফর্মের মতো কিছু সাধারণ তথ্য থাকে। আপনি হোমপেজের নির্মাণের জন্য ইভেন্ট অবজেক্ট ডেটা ব্যবহার করতে পারেন।

ক্যালেন্ডার ইভেন্ট ইন্টারফেস সম্প্রসারিত করা হচ্ছে

ব্যবহারকারী যখন কোনও ক্যালেন্ডার ইভেন্ট সম্পাদনা করেন তখন কোন ইন্টারফেস (যদি থাকে) প্রদর্শন করা হবে তা নির্ধারণ করতে Google ক্যালেন্ডার একটি প্রাসঙ্গিক ট্রিগারের উপর নির্ভর করে। যখন ট্রিগারটি চালু হয়, তখন এটি অ্যাড-অন ম্যানিফেস্টে calendar.eventOpenTrigger ফিল্ড দ্বারা নির্দিষ্ট করা প্রাসঙ্গিক ট্রিগার ফাংশনটি কার্যকর করে।

আপনাকে calendar.eventOpenTrigger ফিল্ডে থাকা ফাংশনটি বাস্তবায়ন করতে হবে। এই ফাংশনটি একটি ইভেন্ট অবজেক্টকে আর্গুমেন্ট হিসেবে গ্রহণ করে এবং ব্যবহারকারীর ইভেন্ট খোলা থাকাকালীন ক্যালেন্ডার প্রদর্শনের জন্য একটি একক Card অবজেক্ট অথবা Card অবজেক্টের একটি অ্যারে ফেরত পাঠাতে হবে।

ইভেন্ট অবজেক্ট

যখন একজন ব্যবহারকারী একটি ক্যালেন্ডার ইভেন্ট খোলেন, তখন একটি ইভেন্ট অবজেক্ট তৈরি করা হয় এবং calendar.eventOpenTrigger প্রাসঙ্গিক ট্রিগার ফাংশনে পাঠানো হয়। ট্রিগার ফাংশনটি এই ইভেন্ট অবজেক্টের তথ্য ব্যবহার করে অ্যাড-অন কার্ড কীভাবে তৈরি করতে হয় বা অ্যাড-অন আচরণ নিয়ন্ত্রণ করতে পারে তা নির্ধারণ করতে পারে। ইভেন্ট অবজেক্টগুলি তৈরি করা হয় এবং homepageTrigger ফাংশনে পাঠানো হয় যখন একটি অ্যাড-অন প্রথম খোলা হয়, এবং যখন ব্যবহারকারী ইন্টারেক্টিভ উইজেটগুলিতে ক্লিক করে বা নির্বাচন করে।

ইভেন্ট অবজেক্টের সম্পূর্ণ কাঠামো Event objects এ বর্ণনা করা হয়েছে। যখন ক্যালেন্ডার অ্যাড-অনের কার্যকরী হোস্ট অ্যাপ হয়, তখন প্রাসঙ্গিক ট্রিগার এবং উইজেট ইন্টারঅ্যাকশন ইভেন্ট অবজেক্টের মধ্যে ক্যালেন্ডার ইভেন্ট অবজেক্ট ফিল্ড অন্তর্ভুক্ত থাকে যা ক্যালেন্ডার-নির্দিষ্ট ক্লায়েন্ট তথ্য বহন করে।

ক্যালেন্ডার ইভেন্ট আপডেট করা হচ্ছে

ব্যবহারকারী যখন সম্পাদনার জন্য একটি ক্যালেন্ডার ইভেন্ট খোলেন তখন প্রাসঙ্গিক calendar.eventOpenTrigger সক্রিয় হয়, আপনি একটি calendar.eventUpdateTrigger সংজ্ঞায়িত করতে পারেন যা ব্যবহারকারী যখন একটি ক্যালেন্ডার ইভেন্ট আপডেট এবং সংরক্ষণ করে তখন সক্রিয় হয়। এই ট্রিগারটি কেবলমাত্র তখনই সক্রিয় হয় যখন ব্যবহারকারী নিম্নলিখিত এক বা একাধিক সম্পাদনা করেন:

• এক বা একাধিক অংশগ্রহণকারীকে যোগ করে।
• এক বা একাধিক অংশগ্রহণকারীকে সরিয়ে দেয়।
• অন্য কোনও কনফারেন্সিং সলিউশন যোগ করে বা স্যুইচ করে।

যখন এই ট্রিগারটি চালু হয়, তখন এটি calendar.eventUpdateTrigger ম্যানিফেস্ট ফিল্ড দ্বারা নির্দিষ্ট ট্রিগার ফাংশনটি কার্যকর করে। ক্যালেন্ডার ইভেন্ট সম্পাদনা সংরক্ষণ করার আগে ফাংশনটি কার্যকর করা হয়।

calendar.eventUpdateTrigger সাধারণত নিম্নলিখিত এক বা একাধিক কাজ করতে ব্যবহৃত হয়:

• ক্যালেন্ডার ইভেন্টে ব্যবহারকারীর পরিবর্তনের প্রতিক্রিয়ায় অ্যাড-অনের ক্যালেন্ডার ইভেন্ট ইন্টারফেস আপডেট করুন।
• ক্যালেন্ডার ইভেন্ট ডেটা কোনও থার্ড-পার্টি সিস্টেমের সাথে সিঙ্ক করুন, যেমন একটি কনফারেন্সিং সিস্টেম যা Google ক্যালেন্ডারের সাথে সংযুক্ত।

যদি আপনার ক্যালেন্ডার ইভেন্টের ডেটা (যেমন এর অংশগ্রহণকারী তালিকা) সামঞ্জস্য করার জন্য আপনার অ্যাড-অনের প্রয়োজন হয়, তাহলে আপনাকে অ্যাড-অন calendar.currentEventAccess ম্যানিফেস্ট ফিল্ডটি WRITE অথবা READ_WRITE এ সেট করতে হবে। এর জন্য অ্যাড-অনটিতে https://www.googleapis.com/auth/calendar.addons.current.event.write scope থাকাও প্রয়োজন।

কনফারেন্সিং সমাধান যোগ করা হচ্ছে

কনফারেন্সিং সলিউশনগুলি একটি তৃতীয় পক্ষের কনফারেন্স বিকল্প উপস্থাপন করে যা ব্যবহারকারীরা Google ক্যালেন্ডার ইভেন্টগুলিতে সংযুক্ত করতে পারেন। তৃতীয় পক্ষের কনফারেন্সিং ওভারভিউ ডকুমেন্টেশনে নতুন কনফারেন্সিং সলিউশন যুক্ত করে এমন একটি অ্যাড-অন কীভাবে তৈরি করতে হয় তার বিশদ বিবরণ দেওয়া হয়েছে। এই ধরণের এক্সটেনশনের জন্য একটি UI তৈরি করার প্রয়োজন নেই; যোগ করা সলিউশনগুলি কেবল Google ক্যালেন্ডার ইভেন্ট UI-এর ড্রপ-ডাউন মেনুতে বিকল্প হিসাবে উপস্থিত হয়।