অ্যাপস স্ক্রিপ্ট ট্রিগার একটি নির্দিষ্ট ইভেন্ট ঘটলে একটি নির্দিষ্ট স্ক্রিপ্ট ফাংশন ( ট্রিগার ফাংশন ) কার্যকর করে। শুধুমাত্র নির্দিষ্ট কিছু ইভেন্টই ট্রিগার সক্রিয় করতে পারে এবং প্রতিটি গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশন ভিন্ন ভিন্ন ইভেন্ট সেট সমর্থন করে।
যখন কোনো ট্রিগার সক্রিয় হয়, তখন একটি ইভেন্ট অবজেক্ট তৈরি হয়। এই JSON কাঠামোটিতে সংঘটিত ঘটনাটির বিস্তারিত বিবরণ থাকে। ট্রিগারের ধরনের ওপর ভিত্তি করে ইভেন্ট অবজেক্ট কাঠামোর তথ্যগুলো ভিন্নভাবে সাজানো থাকে।
ইভেন্ট অবজেক্টটি তৈরি হয়ে গেলে, অ্যাপস স্ক্রিপ্ট এটিকে ট্রিগার ফাংশনে একটি প্যারামিটার হিসেবে পাঠায়। ট্রিগার ফাংশন হলো একটি কলব্যাক ফাংশন, যা ইভেন্টের প্রতিক্রিয়ায় উপযুক্ত পদক্ষেপ নেওয়ার জন্য আপনাকে নিজেই ইমপ্লিমেন্ট করতে হবে। উদাহরণস্বরূপ, জিমেইলকে এক্সটেন্ড করা একটি গুগল ওয়ার্কস্পেস অ্যাড-অনে, আপনি এমন একটি ট্রিগার সংজ্ঞায়িত করতে পারেন যা ব্যবহারকারী একটি মেসেজ থ্রেড খুললে একটি নতুন কার্ড ইন্টারফেস তৈরি করে। এক্ষেত্রে, ইভেন্ট অবজেক্টে পাঠানো ডেটা ব্যবহার করে নতুন UI-এর কার্ডগুলো তৈরি করার জন্য আপনাকে একটি কনটেক্সচুয়াল কলব্যাক ফাংশন ইমপ্লিমেন্ট করতে হবে।
এই পৃষ্ঠায় গুগল ওয়ার্কস্পেস অ্যাড-অন প্রজেক্টে ট্রিগার ব্যবহারের নির্দেশিকা দেওয়া হয়েছে।
প্রকাশ ট্রিগার
এডিটর অ্যাড-অনগুলির মতো নয়, গুগল ওয়ার্কস্পেস অ্যাড-অনগুলি গুগল অ্যাপস স্ক্রিপ্টের সাধারণ ট্রিগার ব্যবহার করতে পারে না। এর পরিবর্তে, এগুলি গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য বিশেষভাবে ডিজাইন করা ট্রিগার ব্যবহার করে: ম্যানিফেস্ট ট্রিগার ।
গুগল ওয়ার্কস্পেস অ্যাড-অন ম্যানিফেস্টে ম্যানিফেস্ট ট্রিগারগুলো সংজ্ঞায়িত করা হয়। উদাহরণস্বরূপ:
- হোমপেজ ট্রিগারগুলো অ্যাড-অন হোমপেজটি তৈরি ও প্রদর্শন করে।
- গুগল ক্যালেন্ডারের eventOpen ট্রিগার, যা কোনো ইভেন্ট খোলা হলে একটি নতুন কার্ড প্রদর্শন করে বা অন্যান্য পদক্ষেপ গ্রহণ করে।
- ক্যালেন্ডার ইভেন্টআপডেট ট্রিগার, যা ব্যবহারকারী কোনো ইভেন্ট সম্পাদনা ও সংরক্ষণ করলে একটি নতুন কার্ড প্রদর্শন করে বা অন্যান্য পদক্ষেপ গ্রহণ করে।
- গুগল ড্রাইভের onItemsSelected ট্রিগারগুলো ব্যবহারকারী ফাইল বা ফোল্ডার নির্বাচন করলে একটি নতুন কার্ড প্রদর্শন করে বা অন্য কোনো পদক্ষেপ গ্রহণ করে।
- জিমেইল কম্পোজ ট্রিগার , যা ব্যবহারকারী কম্পোজ উইন্ডোতে অ্যাড-অনটি খুললে একটি অ্যাড-অন কার্ড প্রদর্শন করে।
- জিমেইলের কনটেক্সচুয়াল ট্রিগার , যা ব্যবহারকারী কোনো মেসেজ খুললে একটি নতুন কার্ড প্রদর্শন করে বা অন্য কোনো পদক্ষেপ গ্রহণ করে।
- যখন ব্যবহারকারীরা ডকুমেন্টের
drive.fileOAuth স্কোপের জন্য অনুমোদন দেন, তখন Editor-এর onFileScopeGranted ট্রিগারটি একটি নতুন কার্ড প্রদর্শন করে।
এই তালিকায়, শুধুমাত্র হোমপেজ ট্রিগারগুলো অ-প্রাসঙ্গিক; বাকিগুলো প্রাসঙ্গিক। ম্যানিফেস্ট ট্রিগার সংজ্ঞা সম্পর্কে আরও তথ্যের জন্য ম্যানিফেস্ট দেখুন।
ম্যানিফেস্ট ট্রিগার ছাড়াও, গুগল ওয়ার্কস্পেস অ্যাড-অনগুলো অ্যাপস স্ক্রিপ্ট ইনস্টলেবল ট্রিগার ব্যবহার করতে পারে।
বিধিনিষেধ
ম্যানিফেস্ট ট্রিগার ব্যবহারের ক্ষেত্রে কিছু সীমাবদ্ধতা রয়েছে।
- এই ট্রিগারগুলো শুধুমাত্র গুগল ওয়ার্কস্পেস অ্যাড-অন প্রজেক্টে ব্যবহৃত হয়।
- যেহেতু এগুলি কোডে নয়, বরং অ্যাড-অন ম্যানিফেস্টে সংজ্ঞায়িত করা থাকে, তাই আপনি এগুলি তৈরি বা পরিবর্তন করার জন্য অ্যাপস
Scriptসার্ভিসটি ব্যবহার করতে পারবেন না। - জিমেইলের কনটেক্সচুয়াল ট্রিগারগুলো ইমেইলের বিষয়বস্তু নির্বিশেষে প্রতিটি বার্তার জন্য সক্রিয় হয়।
- প্রতিটি অ্যাড-অনে, প্রতি ব্যবহারকারী এবং প্রতি ডকুমেন্টের জন্য, প্রতিটি প্রকারের কেবল একটি করে ট্রিগার থাকতে পারে।