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

সাধারণ ট্রিগার এবং ইনস্টলযোগ্য ট্রিগার অ্যাপস স্ক্রিপ্টকে কোনও নির্দিষ্ট ইভেন্ট ঘটলে স্বয়ংক্রিয়ভাবে একটি ফাংশন চালাতে দেয়। যখন একটি ট্রিগার সক্রিয় হয়, তখন অ্যাপস স্ক্রিপ্ট ফাংশনটিকে একটি ইভেন্ট অবজেক্টকে একটি আর্গুমেন্ট হিসেবে পাস করে, যা সাধারণত 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());
}

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

গুগল শিট ইভেন্ট

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

খোলা

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

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

LIMITED
source

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

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

Spreadsheet
triggerUid

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

4034124084959907503
user

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

amin@example.com

সম্পাদনা

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

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

LIMITED
oldValue

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

1234
range

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

Range
source

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

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']

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

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

খোলা

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

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

LIMITED
source

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

Document
triggerUid

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

4034124084959907503
user

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

amin@example.com

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

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

খোলা

( সরল )
authMode

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

LIMITED
source

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

Presentation
user

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

amin@example.com

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

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

খোলা

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

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

LIMITED
source

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

Form
triggerUid

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

4034124084959907503
user

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

amin@example.com

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

ফর্ম জমা দিন

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

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

FULL
response

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

FormResponse
source

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

Form
triggerUid

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

4034124084959907503

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

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

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

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

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

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

( ইনস্টলযোগ্য )
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