Google Workspace অ্যাড-অনগুলির জন্য ট্রিগার

Apps স্ক্রিপ্ট ট্রিগার একটি নির্দিষ্ট স্ক্রিপ্ট ফাংশন ( ট্রিগার ফাংশন ) সঞ্চালনের কারণ যখনই একটি নির্দিষ্ট ঘটনা ঘটে। শুধুমাত্র নির্দিষ্ট কিছু ইভেন্টের কারণে ট্রিগার ফায়ার হতে পারে এবং প্রতিটি Google Workspace অ্যাপ্লিকেশন ইভেন্টের আলাদা সেট সমর্থন করে।

যখন একটি ট্রিগার ফায়ার হয়, একটি ইভেন্ট অবজেক্ট তৈরি হয়। এই JSON কাঠামোতে ঘটে যাওয়া ইভেন্টের বিবরণ রয়েছে। ইভেন্ট অবজেক্ট স্ট্রাকচারের তথ্য ট্রিগার প্রকারের উপর ভিত্তি করে ভিন্নভাবে সংগঠিত হয়।

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

এই পৃষ্ঠাটি Google Workspace অ্যাড-অন প্রোজেক্টে ট্রিগার ব্যবহার করার বিষয়ে নির্দেশিকা প্রদান করে।

ম্যানিফেস্ট ট্রিগার

Editor অ্যাড-অনগুলির বিপরীতে, Google Workspace অ্যাড-অনগুলি বর্তমানে Apps স্ক্রিপ্ট সাধারণ ট্রিগারগুলি ব্যবহার করতে পারে না, পরিবর্তে, তারা বিশেষভাবে Google Workspace অ্যাড-অনগুলির জন্য ডিজাইন করা ট্রিগার ব্যবহার করে: ম্যানিফেস্ট ট্রিগার

ম্যানিফেস্ট ট্রিগারগুলি সম্পূর্ণরূপে Google Workspace অ্যাড-অনের ম্যানিফেস্টে সংজ্ঞায়িত করা হয়েছে। ম্যানিফেস্ট ট্রিগারগুলির উদাহরণগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:

  • হোমপেজ ট্রিগার যা অ্যাড-অন হোমপেজ তৈরি করে এবং প্রদর্শন করে।
  • ক্যালেন্ডার ইভেন্ট ওপেন ট্রিগার যা একটি নতুন কার্ড প্রদর্শন করে বা একটি ক্যালেন্ডার ইভেন্ট খোলা হলে অন্যান্য পদক্ষেপ নেয়।
  • ক্যালেন্ডার ইভেন্টআপডেট ট্রিগার যা একটি নতুন কার্ড প্রদর্শন করে বা অন্যান্য পদক্ষেপ নেয় যখন একজন ব্যবহারকারী একটি ক্যালেন্ডার ইভেন্ট সম্পাদনা করে এবং সংরক্ষণ করে।
  • ড্রাইভ onItemsনির্বাচিত ট্রিগার যা একটি নতুন কার্ড প্রদর্শন করে বা অন্য পদক্ষেপ নেয় যখন একজন ব্যবহারকারী ড্রাইভে এক বা একাধিক ফাইল বা ফোল্ডার নির্বাচন করে।
  • Gmail কম্পোজ ট্রিগার যা একটি অ্যাড-অন কার্ড প্রদর্শন করে যখন ব্যবহারকারী Gmail কম্পোজ উইন্ডোতে অ্যাড-অনটি খোলে।
  • Gmail প্রাসঙ্গিক ট্রিগার যা একটি নতুন কার্ড প্রদর্শন করে বা ব্যবহারকারী যখন একটি Gmail বার্তা খোলে অন্য পদক্ষেপ নেয়।
  • Editor onFileScopeGranted ট্রিগার যা একটি নতুন কার্ড প্রদর্শন করে যখন ব্যবহারকারীরা বর্তমান সম্পাদক নথিতে drive.file OAuth সুযোগের অনুমোদন দেয়।

উপরের তালিকায়, শুধুমাত্র হোমপেজ ট্রিগার অ-প্রসঙ্গগত; বাকিগুলো প্রাসঙ্গিক ট্রিগার। ম্যানিফেস্ট ট্রিগার সংজ্ঞা সম্পর্কে আরও তথ্যের জন্য ম্যানিফেস্ট দেখুন।

ম্যানিফেস্ট ট্রিগার ছাড়াও, Google Workspace অ্যাড-অন অ্যাপস স্ক্রিপ্ট ইনস্টলযোগ্য ট্রিগার ব্যবহার করতে পারে।

বিধিনিষেধ

ম্যানিফেস্ট ট্রিগারগুলির ব্যবহারে নির্দিষ্ট সীমাবদ্ধতা রয়েছে৷

  • এই ট্রিগারগুলি শুধুমাত্র Google Workspace অ্যাড-অন প্রোজেক্টে ব্যবহার করা হয়; অন্য কোন আবেদনে তাদের কোন উদ্দেশ্য নেই।
  • যেহেতু এগুলি অ্যাড-অন ম্যানিফেস্টে সংজ্ঞায়িত করা হয়েছে এবং এর কোডে নয়, আপনি এই ট্রিগারগুলি তৈরি বা সংশোধন করতে Apps স্ক্রিপ্ট Script পরিষেবা ব্যবহার করতে পারবেন না৷
  • Gmail প্রাসঙ্গিক ট্রিগারে বর্তমানে শুধুমাত্র একটি unconditional মানদণ্ড থাকতে পারে। এর মানে বিষয়বস্তু নির্বিশেষে প্রতিটি ইমেল বার্তার জন্য প্রাসঙ্গিক ট্রিগার আগুন।
  • প্রতিটি অ্যাড-অন প্রতি ব্যবহারকারী, প্রতি নথিতে প্রতিটি প্রকারের শুধুমাত্র একটি ট্রিগার থাকতে পারে।