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

সাধারণ ট্রিগার এবং ইনস্টলযোগ্য ট্রিগারগুলি অ্যাপস স্ক্রিপ্টকে একটি নির্দিষ্ট ইভেন্ট ঘটলে স্বয়ংক্রিয়ভাবে একটি ফাংশন চালাতে দেয়। যখন একটি ট্রিগার ফায়ার হয়, অ্যাপস স্ক্রিপ্ট ফাংশনটিকে একটি ইভেন্ট অবজেক্টকে একটি আর্গুমেন্ট হিসাবে পাস করে, সাধারণত বলা হয় e । ইভেন্ট অবজেক্টে সেই প্রসঙ্গ সম্পর্কে তথ্য রয়েছে যা ট্রিগারটি ফায়ার করেছে। উদাহরণস্বরূপ, নীচের নমুনা কোডটি একটি Google পত্রক স্ক্রিপ্টের জন্য একটি সাধারণ onEdit(e) ট্রিগার দেখায় যা কোন সেল সম্পাদিত হয়েছে তা নির্ধারণ করতে ইভেন্ট অবজেক্ট ব্যবহার করে।

function onEdit(e){
  // Set a comment on the edited cell to indicate when it was changed.
  var range = e.range;
  range.setNote('Last modified: ' + new Date());
}

এই পৃষ্ঠাটি বিভিন্ন ধরণের ট্রিগারের জন্য ইভেন্ট অবজেক্টের ক্ষেত্রগুলির বিবরণ দেয়।

ইনস্টলযোগ্য ট্রিগার দ্বারা উত্পাদিত ইভেন্টে একটি triggerUid থাকে যা ইভেন্টটি উৎপন্নকারী ট্রিগারকে চিহ্নিত করে। একাধিক ইনস্টলযোগ্য ট্রিগার আছে এমন স্ক্রিপ্টগুলির জন্য এটি সহায়ক।

Google পত্রক ইভেন্ট

বিভিন্ন Google পত্রক-নির্দিষ্ট ট্রিগার স্ক্রিপ্টগুলিকে একটি স্প্রেডশীটে ব্যবহারকারীর ক্রিয়াকলাপের প্রতিক্রিয়া জানাতে দেয়।

খোলা ( সরল এবং ইনস্টলযোগ্য )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। LIMITED
source	একটি Spreadsheet অবজেক্ট, Google শীট ফাইলের প্রতিনিধিত্ব করে যেখানে স্ক্রিপ্ট আবদ্ধ। Spreadsheet
triggerUid	ট্রিগারের ID যা এই ইভেন্টটি তৈরি করেছে (শুধুমাত্র ইনস্টলযোগ্য ট্রিগার)। 4034124084959907503
user	একটি User অবজেক্ট, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( নিরাপত্তা সীমাবদ্ধতার একটি জটিল সেটের উপর নির্ভর করে )। [e-mail]

পরিবর্তন ( ইনস্টলযোগ্য )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। FULL
changeType	পরিবর্তনের ধরন ( EDIT , INSERT_ROW , INSERT_COLUMN , REMOVE_ROW , REMOVE_COLUMN , INSERT_GRID , REMOVE_GRID , FORMAT , বা OTHER )৷ INSERT_ROW
source	একটি Spreadsheet অবজেক্ট, Google শীট ফাইলের প্রতিনিধিত্ব করে যেখানে স্ক্রিপ্ট আবদ্ধ। Spreadsheet
triggerUid	ট্রিগারের আইডি যা এই ইভেন্টটি তৈরি করেছে। 4034124084959907503
user	একটি User অবজেক্ট, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( নিরাপত্তা সীমাবদ্ধতার একটি জটিল সেটের উপর নির্ভর করে )। [e-mail]

সম্পাদনা করুন ( সরল এবং ইনস্টলযোগ্য )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। LIMITED
oldValue	সম্পাদনার আগে ঘরের মান, যদি থাকে। শুধুমাত্র সম্পাদিত পরিসর একটি একক কক্ষ হলেই উপলব্ধ৷ কক্ষে পূর্ববর্তী কোনো বিষয়বস্তু না থাকলে অনির্ধারিত হবে। 1234
range	একটি Range অবজেক্ট, কক্ষ বা কক্ষের পরিসর যা সম্পাদিত হয়েছে তা প্রতিনিধিত্ব করে। Range
source	একটি Spreadsheet অবজেক্ট, Google শীট ফাইলের প্রতিনিধিত্ব করে যেখানে স্ক্রিপ্ট আবদ্ধ। Spreadsheet
triggerUid	ট্রিগারের ID যা এই ইভেন্টটি তৈরি করেছে (শুধুমাত্র ইনস্টলযোগ্য ট্রিগার)। 4034124084959907503
user	একটি User অবজেক্ট, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( নিরাপত্তা সীমাবদ্ধতার একটি জটিল সেটের উপর নির্ভর করে )। [e-mail]
value	সম্পাদনার পর নতুন কক্ষের মান। শুধুমাত্র সম্পাদিত পরিসর একটি একক কক্ষ হলেই উপলব্ধ৷ 10

ফর্ম জমা দিন ( ইনস্টলযোগ্য )
সতর্কতা: আপনি SpreadsheetTriggerBuilder এর সাথে এই ফর্ম জমা ট্রিগার ব্যবহার করেছেন তা নিশ্চিত করুন।
authMode	ScriptApp.AuthMode enum থেকে একটি মান। FULL
namedValues	ফর্ম জমা থেকে প্রশ্ন নাম এবং মান ধারণকারী একটি বস্তু. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] }
range	একটি Range অবজেক্ট, কক্ষ বা কক্ষের পরিসর যা সম্পাদিত হয়েছে তা প্রতিনিধিত্ব করে। Range
triggerUid	ট্রিগারের আইডি যা এই ইভেন্টটি তৈরি করেছে। 4034124084959907503
values	স্প্রেডশীটে প্রদর্শিত মানগুলির সাথে একই ক্রমে অ্যারে। ['2015/05/04 15:00', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

Google ডক্স ইভেন্ট

ট্রিগারগুলি Google ডক্সকে প্রতিক্রিয়া জানাতে অনুমতি দেয় যখন একজন ব্যবহারকারী একটি নথি খোলে।

খোলা ( সরল এবং ইনস্টলযোগ্য )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। LIMITED
source	একটি Document অবজেক্ট, Google ডক্স ফাইলের প্রতিনিধিত্ব করে যেখানে স্ক্রিপ্ট আবদ্ধ। Document
triggerUid	ট্রিগারের ID যা এই ইভেন্টটি তৈরি করেছে (শুধুমাত্র ইনস্টলযোগ্য ট্রিগার)। 4034124084959907503
user	একটি User অবজেক্ট, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( নিরাপত্তা সীমাবদ্ধতার একটি জটিল সেটের উপর নির্ভর করে )। [e-mail]

Google স্লাইড ইভেন্ট

ট্রিগারগুলি Google স্লাইডকে প্রতিক্রিয়া জানাতে অনুমতি দেয় যখন একজন ব্যবহারকারী একটি উপস্থাপনা খোলে।

খোলা ( সরল )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। LIMITED
source	একটি Presentation অবজেক্ট, Google স্লাইড ফাইলের প্রতিনিধিত্ব করে যেখানে স্ক্রিপ্ট আবদ্ধ। Presentation
user	একটি User অবজেক্ট, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( নিরাপত্তা সীমাবদ্ধতার একটি জটিল সেটের উপর নির্ভর করে )। [e-mail]

Google ফর্ম ইভেন্ট

Google ফর্ম-নির্দিষ্ট ট্রিগারগুলি যখন একজন ব্যবহারকারী একটি ফর্ম সম্পাদনা করে বা একটি প্রতিক্রিয়া জমা দেয় তখন স্ক্রিপ্টগুলিকে প্রতিক্রিয়া জানাতে দেয়৷

খোলা * ( সরল এবং ইনস্টলযোগ্য )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। LIMITED
source	একটি Form অবজেক্ট, Google ফর্ম ফাইলের প্রতিনিধিত্ব করে যেখানে স্ক্রিপ্ট আবদ্ধ। Form
triggerUid	ট্রিগারের ID যা এই ইভেন্টটি তৈরি করেছে (শুধুমাত্র ইনস্টলযোগ্য ট্রিগার)। 4034124084959907503
user	একটি User অবজেক্ট, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( নিরাপত্তা সীমাবদ্ধতার একটি জটিল সেটের উপর নির্ভর করে )। [e-mail]

* এই ঘটনাটি ঘটে না যখন একজন ব্যবহারকারী প্রতিক্রিয়া জানাতে একটি ফর্ম খোলেন, বরং যখন একজন সম্পাদক ফর্মটি সংশোধন করার জন্য খোলেন।

ফর্ম জমা দিন ( ইনস্টলযোগ্য )
সতর্কতা: আপনি FormTriggerBuilder এর সাথে এই ফর্ম জমা ট্রিগার ব্যবহার করছেন তা নিশ্চিত করুন।
authMode	ScriptApp.AuthMode enum থেকে একটি মান। FULL
response	একটি FormResponse অবজেক্ট, সামগ্রিকভাবে ফর্মটিতে ব্যবহারকারীর প্রতিক্রিয়া উপস্থাপন করে। FormResponse
source	একটি Form অবজেক্ট, Google ফর্ম ফাইলের প্রতিনিধিত্ব করে যেখানে স্ক্রিপ্ট আবদ্ধ। Form
triggerUid	ট্রিগারের আইডি যা এই ইভেন্টটি তৈরি করেছে। 4034124084959907503

গুগল ক্যালেন্ডার ইভেন্ট

যখন একজন ব্যবহারকারীর ক্যালেন্ডার ইভেন্ট আপডেট করা হয় (তৈরি, সম্পাদিত বা মুছে ফেলা হয়) তখন ক্যালেন্ডার ফায়ার করে।

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

অ্যাপস স্ক্রিপ্টে ক্যালেন্ডারের সাথে সিঙ্ক্রোনাইজ করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:

1. স্ক্রিপ্ট প্রকল্পের জন্য ক্যালেন্ডার উন্নত পরিষেবা সক্ষম করুন৷ অন্তর্নির্মিত ক্যালেন্ডার পরিষেবা এই কর্মপ্রবাহের জন্য যথেষ্ট নয়৷
2. কোন ক্যালেন্ডার সিঙ্ক্রোনাইজ করা উচিত তা নির্ধারণ করুন। এই জাতীয় প্রতিটি ক্যালেন্ডারের জন্য, ক্যালেন্ডার উন্নত পরিষেবার Events.list() পদ্ধতি ব্যবহার করে একটি প্রাথমিক সিঙ্ক অপারেশন করুন৷
3. প্রাথমিক সিঙ্কের ফলাফল সেই ক্যালেন্ডারের জন্য একটি nextSyncToken প্রদান করে। পরে ব্যবহারের জন্য এই টোকেন সংরক্ষণ করুন।
4. যখন অ্যাপস স্ক্রিপ্ট EventUpdated ট্রিগার একটি ক্যালেন্ডার ইভেন্ট পরিবর্তনের ইঙ্গিত দেয়, তখন সংরক্ষিত nextSyncToken ব্যবহার করে প্রভাবিত ক্যালেন্ডারের জন্য একটি ক্রমবর্ধমান সিঙ্ক করুন। এটি মূলত অন্য একটি Events.list() অনুরোধ, কিন্তু nextSyncToken প্রদান করা শুধুমাত্র ইভেন্টের প্রতিক্রিয়া সীমিত করে যা শেষ সিঙ্কের পর থেকে পরিবর্তিত হয়েছে।
5. কোন ইভেন্টগুলি আপডেট করা হয়েছে তা জানতে সিঙ্কের প্রতিক্রিয়া পরীক্ষা করুন এবং আপনার কোডটি যথাযথভাবে প্রতিক্রিয়া জানাতে। উদাহরণস্বরূপ, আপনি পরিবর্তনটি লগ করতে, একটি স্প্রেডশীট আপডেট করতে, ইমেল বিজ্ঞপ্তি পাঠাতে বা অন্যান্য পদক্ষেপ নিতে পারেন৷
6. ক্রমবর্ধমান সিঙ্ক অনুরোধ দ্বারা ফিরে আসা একটি দিয়ে সেই ক্যালেন্ডারের জন্য আপনার সংরক্ষিত nextSyncToken সিঙ্ক টোকেন আপডেট করুন। এটি পরবর্তী সিঙ্ক অপারেশনকে শুধুমাত্র সবচেয়ে বর্তমান পরিবর্তনগুলি ফিরিয়ে দিতে বাধ্য করে।

সতর্কতা: মাঝে মাঝে সিঙ্ক টোকেনগুলি সার্ভার দ্বারা অবৈধ হয়ে যায়, যার ফলে একটি 410 ত্রুটি হয়৷ যখন এটি ঘটবে, আপনার কোডটি একটি সম্পূর্ণ সিঙ্ক পরিচালনা করা উচিত এবং সেই ক্যালেন্ডারের জন্য আপনার কাছে থাকা সমস্ত সঞ্চিত সিঙ্ক করা ডেটা এবং টোকেনগুলি প্রতিস্থাপন করা উচিত৷

ইভেন্ট আপডেট করা হয়েছে ( ইনস্টলযোগ্য )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। FULL
calendarId	ক্যালেন্ডারের স্ট্রিং আইডি যেখানে ইভেন্ট আপডেট হয়েছে। [e-mail]
triggerUid	ট্রিগারের আইডি যা এই ইভেন্টটি তৈরি করেছে। 4034124084959907503

Google Workspace অ্যাড-অন ইভেন্ট

একজন ব্যবহারকারী একটি অ্যাড-অন ইনস্টল করলে onInstall() ট্রিগার স্বয়ংক্রিয়ভাবে চলে।

ইনস্টল করুন ( সরল )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। FULL

গুগল চ্যাট অ্যাপ ইভেন্ট

Google Chat-এ ইভেন্ট অবজেক্ট সম্পর্কে জানতে, আপনার Google Chat অ্যাপের সাথে ইন্টারঅ্যাকশন গ্রহণ এবং প্রতিক্রিয়া দেখুন।

সময়-চালিত ঘটনা

সময়-চালিত ট্রিগার (যাকে ক্লক ট্রিগারও বলা হয়) স্ক্রিপ্টগুলিকে একটি নির্দিষ্ট সময়ে বা পুনরাবৃত্ত বিরতিতে কার্যকর করতে দেয়।

সময়-চালিত ( ইনস্টলযোগ্য )
authMode	ScriptApp.AuthMode enum থেকে একটি মান। FULL
day-of-month	1 থেকে 31 এর মধ্যে। কারণ এই সম্পত্তির নামটিতে ড্যাশ রয়েছে এটি ডট নোটেশনের পরিবর্তে e['day-of-month'] এর মাধ্যমে অ্যাক্সেস করতে হবে। 31
day-of-week	1 (সোমবার) থেকে 7 (রবিবার) এর মধ্যে। কারণ এই সম্পত্তির নামটিতে ড্যাশ রয়েছে এটি ডট নোটেশনের পরিবর্তে e['day-of-week'] এর মাধ্যমে অ্যাক্সেস করতে হবে। 7
hour	0 থেকে 23 এর মধ্যে। 23
minute	0 থেকে 59 এর মধ্যে। 59
month	1 থেকে 12 এর মধ্যে। 12
second	0 থেকে 59 এর মধ্যে। 59
timezone	সময় অঞ্চল। UTC
triggerUid	ট্রিগারের আইডি যা এই ইভেন্টটি তৈরি করেছে। 4034124084959907503
week-of-year	1 থেকে 52 এর মধ্যে। কারণ এই সম্পত্তির নামটিতে ড্যাশ রয়েছে এটি ডট নোটেশনের পরিবর্তে e['week-of-year'] এর মাধ্যমে অ্যাক্সেস করতে হবে। 52
year	বছর. 2015