সাধারণ ট্রিগারের মতো, ইনস্টলযোগ্য ট্রিগারগুলি অ্যাপস স্ক্রিপ্টকে স্বয়ংক্রিয়ভাবে একটি ফাংশন চালাতে দেয় যখন কোনও নির্দিষ্ট ঘটনা, যেমন একটি ডকুমেন্ট খোলা, ঘটে। তবে, ইনস্টলযোগ্য ট্রিগারগুলি সাধারণ ট্রিগারগুলির তুলনায় বেশি নমনীয়তা প্রদান করে: তারা অনুমোদনের প্রয়োজন এমন পরিষেবাগুলিকে কল করতে পারে, তারা সময়-চালিত (ঘড়ি) ট্রিগার সহ বেশ কয়েকটি অতিরিক্ত ধরণের ইভেন্ট অফার করে এবং সেগুলিকে প্রোগ্রাম্যাটিকভাবে নিয়ন্ত্রণ করা যেতে পারে। সহজ এবং ইনস্টলযোগ্য উভয় ট্রিগারের জন্য, অ্যাপস স্ক্রিপ্ট ট্রিগার করা ফাংশনটিকে একটি ইভেন্ট অবজেক্ট পাস করে যাতে ঘটনাটি যে প্রেক্ষাপটে ঘটেছে সে সম্পর্কে তথ্য থাকে।
বিধিনিষেধ
যদিও ইনস্টলযোগ্য ট্রিগারগুলি সাধারণ ট্রিগারগুলির তুলনায় বেশি নমনীয়তা প্রদান করে, তবুও সেগুলিতে বেশ কয়েকটি বিধিনিষেধ রয়েছে:
- শুধুমাত্র পঠনযোগ্য (দেখুন বা মন্তব্য করুন) মোডে কোনও ফাইল খোলা থাকলে এগুলি চলে না। স্বতন্ত্র স্ক্রিপ্টগুলির জন্য, ট্রিগারগুলি সঠিকভাবে চালানোর জন্য ব্যবহারকারীদের কমপক্ষে স্ক্রিপ্ট ফাইলে দেখার অ্যাক্সেস প্রয়োজন।
স্ক্রিপ্ট এক্সিকিউশন এবং API অনুরোধগুলি ট্রিগার চালানোর কারণ হয় না। উদাহরণস্বরূপ, একটি নতুন ফর্ম প্রতিক্রিয়া জমা দেওয়ার জন্য
FormResponse.submit()কল করলে ফর্মের সাবমিট ট্রিগার চালানো হয় না।ইনস্টলযোগ্য ট্রিগারগুলি সর্বদা সেই ব্যক্তির অ্যাকাউন্টের অধীনে চলে যিনি এটি তৈরি করেছেন। উদাহরণস্বরূপ, যদি আপনি একটি ইনস্টলযোগ্য ওপেন ট্রিগার তৈরি করেন, তবে এটি আপনার সহকর্মী ডকুমেন্টটি খুললে (যদি আপনার সহকর্মীর সম্পাদনা অ্যাক্সেস থাকে) কাজ করে, তবে এটি আপনার অ্যাকাউন্ট হিসাবে চলে। এর অর্থ হল, যদি আপনি কোনও ডকুমেন্ট খোলার সময় ইমেল পাঠানোর জন্য একটি ট্রিগার তৈরি করেন, তবে ইমেলটি সর্বদা আপনার অ্যাকাউন্ট থেকে পাঠানো হবে, অগত্যা যে অ্যাকাউন্টটি ডকুমেন্টটি খুলেছে তা নয়। তবে, আপনি প্রতিটি অ্যাকাউন্টের জন্য একটি ইনস্টলযোগ্য ট্রিগার তৈরি করতে পারেন, যার ফলে প্রতিটি অ্যাকাউন্ট থেকে একটি ইমেল পাঠানো হবে।
একটি অ্যাকাউন্ট দ্বিতীয় অ্যাকাউন্ট থেকে ইনস্টল করা ট্রিগারগুলি দেখতে পাবে না, যদিও প্রথম অ্যাকাউন্টটি এখনও সেই ট্রিগারগুলি সক্রিয় করতে পারে।
ইনস্টলযোগ্য ট্রিগারগুলি অ্যাপস স্ক্রিপ্ট ট্রিগার কোটা সীমার অধীন।
সময়-চালিত ট্রিগার
একটি সময়-চালিত ট্রিগার (যাকে ঘড়ির ট্রিগারও বলা হয়) ইউনিক্সের ক্রোন জবের মতো। সময়-চালিত ট্রিগারগুলি স্ক্রিপ্টগুলিকে একটি নির্দিষ্ট সময়ে বা পুনরাবৃত্ত ব্যবধানে, প্রতি মিনিটে যতবার বা কদাচিৎ প্রতি মাসে একবার চালানোর অনুমতি দেয়। (মনে রাখবেন যে একটি অ্যাড-অন প্রতি ঘন্টায় সর্বাধিক একবার সময়-চালিত ট্রিগার ব্যবহার করতে পারে।) সময়টি সামান্য এলোমেলোভাবে করা যেতে পারে—উদাহরণস্বরূপ, যদি আপনি একটি পুনরাবৃত্ত 9 AM ট্রিগার তৈরি করেন, তাহলে Apps Script 9 AM থেকে 10 AM এর মধ্যে একটি সময় বেছে নেয়, তারপর সেই সময়কালকে প্রতিদিন সামঞ্জস্যপূর্ণ রাখে যাতে ট্রিগারটি আবার চালু হওয়ার আগে 24 ঘন্টা কেটে যায়।
ইভেন্ট-চালিত ট্রিগার
ইনস্টলযোগ্য ইভেন্ট-চালিত ট্রিগারগুলি ধারণাগতভাবে onOpen() মতো সাধারণ ট্রিগারগুলির মতো, তবে তারা অতিরিক্ত ইভেন্টগুলিতে প্রতিক্রিয়া জানাতে পারে এবং তারা ভিন্নভাবে আচরণ করে।
উদাহরণস্বরূপ, Google Sheets-এর জন্য ইনস্টলযোগ্য ওপেন ট্রিগার সক্রিয় হয় যখনই সম্পাদনা অ্যাক্সেস আছে এমন যেকোনো ব্যবহারকারী স্প্রেডশিটটি খোলে, ঠিক যেমনটি সহজ onOpen() ট্রিগার। তবে, ইনস্টলযোগ্য সংস্করণটি এমন পরিষেবাগুলিকে কল করতে পারে যার জন্য অনুমোদন প্রয়োজন। ইনস্টলযোগ্য সংস্করণটি ট্রিগার তৈরিকারী ব্যবহারকারীর অনুমোদনের সাথে চলে, এমনকি সম্পাদনা অ্যাক্সেস আছে এমন অন্য ব্যবহারকারী স্প্রেডশিটটি খোলে।
গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশনের জন্য বেশ কয়েকটি ইনস্টলযোগ্য ট্রিগার রয়েছে:
- যখন একজন ব্যবহারকারী এমন একটি স্প্রেডশিট, ডকুমেন্ট বা ফর্ম খোলেন যা সম্পাদনা করার অনুমতি তাদের আছে, তখন একটি ইনস্টলযোগ্য ওপেন ট্রিগার চলে।
- যখন একজন ব্যবহারকারী স্প্রেডশিটে একটি মান পরিবর্তন করেন, তখন একটি ইনস্টলযোগ্য সম্পাদনা ট্রিগার চলে।
- যখন একজন ব্যবহারকারী স্প্রেডশিটের কাঠামো নিজেই পরিবর্তন করেন - উদাহরণস্বরূপ, একটি নতুন শীট যুক্ত করে বা একটি কলাম সরিয়ে দিয়ে - তখন একটি ইনস্টলযোগ্য পরিবর্তন ট্রিগার চলে।
- যখন কোনও ব্যবহারকারী কোনও ফর্মের প্রতিক্রিয়া জানায় তখন একটি ইনস্টলযোগ্য ফর্ম জমা দেওয়ার ট্রিগার চলে। ফর্ম-সাবমিট ট্রিগারের দুটি সংস্করণ রয়েছে, একটি গুগল ফর্মের জন্য এবং একটি শীটের জন্য যদি ফর্মটি একটি স্প্রেডশিটে জমা দেওয়া হয় ।
- যখন কোনও ব্যবহারকারীর ক্যালেন্ডার ইভেন্ট আপডেট করা হয়—তৈরি, সম্পাদনা করা বা মুছে ফেলা হয়—তখন একটি ইনস্টলযোগ্য ক্যালেন্ডার ইভেন্ট ট্রিগার চালু হয়।
আপনি স্বতন্ত্র এবং আবদ্ধ স্ক্রিপ্টগুলিতে ইনস্টলযোগ্য ট্রিগার ব্যবহার করতে পারেন। উদাহরণস্বরূপ, একটি স্বতন্ত্র স্ক্রিপ্ট প্রোগ্রাম্যাটিকভাবে TriggerBuilder.forSpreadsheet(key) কল করে এবং স্প্রেডশিটের আইডি পাস করে একটি ইচ্ছামত Google Sheets ফাইলের জন্য একটি ইনস্টলযোগ্য ট্রিগার তৈরি করতে পারে।
ট্রিগারগুলি ম্যানুয়ালি পরিচালনা করুন
স্ক্রিপ্ট এডিটরে ম্যানুয়ালি একটি ইনস্টলযোগ্য ট্রিগার তৈরি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টটি খুলুন।
- বাম দিকে, ট্রিগারস ক্লিক করুন।
- নীচে ডানদিকে, Add Trigger এ ক্লিক করুন।
- আপনি যে ধরণের ট্রিগার তৈরি করতে চান তা নির্বাচন করুন এবং কনফিগার করুন।
- সংরক্ষণ করুন ক্লিক করুন।
প্রোগ্রাম্যাটিকভাবে ট্রিগার পরিচালনা করুন
আপনি Script পরিষেবা ব্যবহার করে প্রোগ্রাম্যাটিকভাবে ট্রিগার তৈরি এবং মুছে ফেলতে পারেন। ScriptApp.newTrigger(functionName) কল করে শুরু করুন, যা একটি TriggerBuilder প্রদান করে।
নিচের উদাহরণটি দেখায় কিভাবে দুটি সময়-চালিত ট্রিগার তৈরি করতে হয়—একটি যা প্রতি ৬ ঘন্টা অন্তর সক্রিয় হয় এবং অন্যটি যা প্রতি সোমবার সকাল ৯ টায় সক্রিয় হয় (আপনার স্ক্রিপ্ট যে সময় অঞ্চলে সেট করা আছে)।
পরবর্তী উদাহরণে দেখানো হয়েছে কিভাবে একটি স্প্রেডশিটের জন্য একটি ইনস্টলযোগ্য ওপেন ট্রিগার তৈরি করতে হয়। মনে রাখবেন, একটি সাধারণ onOpen() ট্রিগারের বিপরীতে, ইনস্টলযোগ্য ট্রিগারের স্ক্রিপ্টটি স্প্রেডশিটের সাথে আবদ্ধ হওয়ার প্রয়োজন নেই। একটি স্বতন্ত্র স্ক্রিপ্ট থেকে এই ট্রিগারটি তৈরি করতে, কেবল SpreadsheetApp.getActive() SpreadsheetApp.openById(id) এ কল দিয়ে প্রতিস্থাপন করুন।
একটি বিদ্যমান ইনস্টলযোগ্য ট্রিগার প্রোগ্রাম্যাটিকভাবে পরিবর্তন করতে, আপনাকে এটি মুছে ফেলতে হবে এবং একটি নতুন তৈরি করতে হবে। যদি আপনি পূর্বে একটি ট্রিগারের আইডি সংরক্ষণ করে থাকেন, তাহলে আপনি নীচের ফাংশনে একটি আর্গুমেন্ট হিসাবে আইডিটি পাস করে এটি মুছে ফেলতে পারেন।
ট্রিগার তৈরি করার আগে, আমরা আপনাকে যাচাই করার পরামর্শ দিচ্ছি যে সংশ্লিষ্ট ফাংশনটিতে সমস্ত প্রয়োজনীয় OAuth অনুমতি রয়েছে কিনা।
ট্রিগারগুলিতে ত্রুটি
যখন একটি ইনস্টলযোগ্য ট্রিগার চালু হয় কিন্তু ফাংশনটি একটি ব্যতিক্রম দেয় অথবা অন্যথায় সফলভাবে চালাতে ব্যর্থ হয়, তখন আপনি আপনার স্ক্রিনে একটি ত্রুটি বার্তা দেখতে পান না। সর্বোপরি, যখন একটি সময়-চালিত ট্রিগার চলে বা অন্য কোনও ব্যবহারকারী আপনার ফর্ম-সাবমিট ট্রিগার সক্রিয় করে, তখন আপনি আপনার কম্পিউটারে নাও থাকতে পারেন।
পরিবর্তে, অ্যাপস স্ক্রিপ্ট আপনাকে নিম্নলিখিত ধরণের একটি ইমেল পাঠাবে:
From: noreply-apps-scripts-notifications@google.com Subject: Summary of failures for Google Apps Script Your script has recently failed to finish successfully. A summary of the failure(s) is shown below.
ইমেলটিতে ট্রিগারটি নিষ্ক্রিয় বা পুনরায় কনফিগার করার জন্য একটি লিঙ্ক রয়েছে। যদি স্ক্রিপ্টটি কোনও Google Sheets, Docs, অথবা Forms ফাইলের সাথে আবদ্ধ থাকে, তাহলে ইমেলটিতে সেই ফাইলের একটি লিঙ্কও অন্তর্ভুক্ত থাকে। এই লিঙ্কগুলি আপনাকে ট্রিগারটি নিষ্ক্রিয় করতে বা বাগটি ঠিক করতে স্ক্রিপ্ট সম্পাদনা করতে দেয়।
আপনার গুগল অ্যাকাউন্টের সাথে সম্পর্কিত সমস্ত ট্রিগার পর্যালোচনা করতে এবং আপনার আর প্রয়োজন নেই এমন ট্রিগারগুলি নিষ্ক্রিয় করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
-
script.google.comএ যান। - বাম দিকে, My Triggers এ ক্লিক করুন।
- ট্রিগার মুছে ফেলার জন্য, ট্রিগারের ডানদিকে, More > Delete trigger এ ক্লিক করুন।
যদি কোনও ট্রিগার নিষ্ক্রিয় করা হয়, তাহলে তার সাথে সম্পর্কিত ব্যর্থতার বিজ্ঞপ্তিগুলিও নিষ্ক্রিয় করা হয়। ব্যর্থতার বিজ্ঞপ্তিগুলি একটি সক্রিয় ট্রিগারের একটি অন্তর্নিহিত অংশ। ফলস্বরূপ, একটি নির্দিষ্ট ট্রিগারের জন্য সমস্ত ব্যর্থতার বিজ্ঞপ্তি পাওয়া বন্ধ করতে, আপনাকে ট্রিগারটি নিজেই নিষ্ক্রিয় বা মুছে ফেলতে হবে। যখন একটি ট্রিগার সক্রিয় থাকে, তখন আপনি কেবল এই বিজ্ঞপ্তিগুলির ফ্রিকোয়েন্সি সামঞ্জস্য করতে পারেন।
Note: Simple triggers like `onOpen()` can't be deactivated from this
page; instead, you must edit the appropriate script and remove or rename
the `onOpen()` function.
অ্যাড-অনগুলিতে ট্রিগার
ইনস্টলযোগ্য ট্রিগার ছাড়াও, আপনি অ্যাড-অনগুলিতে ম্যানিফেস্ট ট্রিগার ব্যবহার করতে পারেন। আরও তথ্যের জন্য, Google Workspace অ্যাড-অনের জন্য ট্রিগার দেখুন।