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

কোনও নির্দিষ্ট ঘটনা ঘটলে সরল ট্রিগার এবং ইনস্টলযোগ্য ট্রিগারগুলি Google Apps Script কে স্বয়ংক্রিয়ভাবে একটি ফাংশন চালাতে দেয়। যখন কোনও ট্রিগার সক্রিয় হয়, তখন Apps Script ফাংশনটিকে একটি ইভেন্ট অবজেক্টকে একটি আর্গুমেন্ট হিসাবে পাস করে, সাধারণত e । ইভেন্ট অবজেক্টে ট্রিগারটি সক্রিয় হওয়ার কারণ সম্পর্কে তথ্য থাকে। উদাহরণস্বরূপ, নিম্নলিখিত নমুনা কোডটি একটি Google Sheets স্ক্রিপ্টের জন্য একটি সহজ 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 Sheets-নির্দিষ্ট ট্রিগার স্ক্রিপ্টগুলিকে একটি স্প্রেডশিটে ব্যবহারকারীর ক্রিয়াকলাপের প্রতিক্রিয়া জানাতে দেয়।

খোলা

( সহজ এবং ইনস্টলযোগ্য )
authMode

ScriptApp.AuthMode enum থেকে একটি মান।

LIMITED
source

একটি Spreadsheet অবজেক্ট, যা শীট ফাইলের প্রতিনিধিত্ব করে যার সাথে স্ক্রিপ্টটি আবদ্ধ।

Spreadsheet
triggerUid

এই ইভেন্টটি তৈরি করা ট্রিগারের আইডি (শুধুমাত্র ইনস্টলযোগ্য ট্রিগার)।

4034124084959907503
user

একটি User বস্তু, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( জটিল নিরাপত্তা বিধিনিষেধের উপর নির্ভর করে )।

amin@example.com

পরিবর্তন

( ইনস্টলযোগ্য )
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 অবজেক্ট, যা শীট ফাইলের প্রতিনিধিত্ব করে যার সাথে স্ক্রিপ্টটি আবদ্ধ।

Spreadsheet
triggerUid

এই ইভেন্টটি তৈরি করা ট্রিগারের আইডি।

4034124084959907503
user

একটি User বস্তু, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( জটিল নিরাপত্তা বিধিনিষেধের উপর নির্ভর করে )। 

amin@example.com

সম্পাদনা

( সহজ এবং ইনস্টলযোগ্য )
authMode

ScriptApp.AuthMode enum থেকে একটি মান। 

LIMITED
oldValue

সম্পাদনার পূর্বে কক্ষের মান, যদি থাকে। সম্পাদিত পরিসরটি একটি একক কক্ষ হলেই কেবল উপলব্ধ। যদি কক্ষটিতে পূর্ববর্তী কোনও সামগ্রী না থাকে তবে অনির্ধারিত। 

1234
range

একটি Range অবজেক্ট, যা সম্পাদিত কোষ বা কোষের পরিসরকে প্রতিনিধিত্ব করে। 

Range
source

একটি Spreadsheet অবজেক্ট, যা শীট ফাইলের প্রতিনিধিত্ব করে যার সাথে স্ক্রিপ্টটি আবদ্ধ। 

Spreadsheet
triggerUid

এই ইভেন্টটি তৈরি করা ট্রিগারের আইডি (শুধুমাত্র ইনস্টলযোগ্য ট্রিগার)। 

4034124084959907503
user

একটি User বস্তু, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( জটিল নিরাপত্তা বিধিনিষেধের উপর নির্ভর করে )। 

amin@example.com
value

সম্পাদনার পরে নতুন কক্ষের মান। সম্পাদিত পরিসরটি একটি একক কক্ষ হলেই কেবল উপলব্ধ। 

10

ফর্ম জমা দিন

( ইনস্টলযোগ্য )
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', 'amin@example.com', 'Bob', '27', 'Bill',
'28', 'Susan', '25']

গুগল ডক্স ইভেন্ট

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

খোলা

( সহজ এবং ইনস্টলযোগ্য )
authMode

ScriptApp.AuthMode enum থেকে একটি মান। 

LIMITED
source

একটি Document অবজেক্ট, যা ডক্স ফাইলের প্রতিনিধিত্ব করে যার সাথে স্ক্রিপ্টটি আবদ্ধ। 

Document
triggerUid

এই ইভেন্টটি তৈরি করা ট্রিগারের আইডি (শুধুমাত্র ইনস্টলযোগ্য ট্রিগার)। 

4034124084959907503
user

একটি User বস্তু, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( জটিল নিরাপত্তা বিধিনিষেধের উপর নির্ভর করে )। 

amin@example.com

গুগল স্লাইডস ইভেন্ট

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

খোলা

( সরল )
authMode

ScriptApp.AuthMode enum থেকে একটি মান। 

LIMITED
source

একটি Presentation অবজেক্ট, যা স্ক্রিপ্টটি যে স্লাইড ফাইলের সাথে আবদ্ধ তা উপস্থাপন করে। 

Presentation
user

একটি User বস্তু, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( জটিল নিরাপত্তা বিধিনিষেধের উপর নির্ভর করে )। 

amin@example.com

গুগল ফর্ম ইভেন্ট

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

খোলা

* ( সহজ এবং ইনস্টলযোগ্য )
authMode

ScriptApp.AuthMode enum থেকে একটি মান। 

LIMITED
source

একটি Form অবজেক্ট, যা ফর্ম ফাইলের প্রতিনিধিত্ব করে যার সাথে স্ক্রিপ্টটি আবদ্ধ। 

Form
triggerUid

এই ইভেন্টটি তৈরি করা ট্রিগারের আইডি (শুধুমাত্র ইনস্টলযোগ্য ট্রিগার)। 

4034124084959907503
user

একটি User বস্তু, সক্রিয় ব্যবহারকারীর প্রতিনিধিত্ব করে, যদি উপলব্ধ থাকে ( জটিল নিরাপত্তা বিধিনিষেধের উপর নির্ভর করে )। 

amin@example.com

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

ফর্ম জমা দিন

( ইনস্টলযোগ্য )
authMode

ScriptApp.AuthMode enum থেকে একটি মান। 

FULL
response

একটি FormResponse অবজেক্ট, যা সম্পূর্ণ ফর্মের প্রতি ব্যবহারকারীর প্রতিক্রিয়া উপস্থাপন করে। 

FormResponse
source

একটি Form অবজেক্ট, যা ফর্ম ফাইলের প্রতিনিধিত্ব করে যার সাথে স্ক্রিপ্টটি আবদ্ধ। 

Form
triggerUid

এই ইভেন্টটি তৈরি করা ট্রিগারের আইডি। 

4034124084959907503

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

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

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

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

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

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

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

( ইনস্টলযোগ্য )
authMode

ScriptApp.AuthMode enum থেকে একটি মান। 

FULL
calendarId

যে ক্যালেন্ডারে ইভেন্ট আপডেটটি ঘটেছে তার স্ট্রিং আইডি। 

susan@example.com
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