इवेंट के ऑब्जेक्ट

आसान ट्रिगर और इंस्टॉल किए जा सकने वाले ट्रिगर की मदद से, 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 इवेंट

Google Sheets के लिए बने अलग-अलग तरह के ट्रिगर की मदद से स्क्रिप्ट, स्प्रेडशीट में उपयोगकर्ता की कार्रवाइयों का जवाब देती हैं.

ओपन (आसान और इंस्टॉल किया जा सकता है)
authMode	ScriptApp.AuthMode Enum से कोई वैल्यू. LIMITED
source	Spreadsheet ऑब्जेक्ट, वह Google Sheets फ़ाइल दिखाता है जिससे स्क्रिप्ट जुड़ी हुई है. Spreadsheet
triggerUid	उस ट्रिगर का आईडी जिसने यह इवेंट बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर). 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 Sheets की वह फ़ाइल दिखाता है जिससे स्क्रिप्ट जुड़ी हुई है. Spreadsheet
triggerUid	उस ट्रिगर का आईडी जिसने यह इवेंट बनाया. 4034124084959907503
user	User ऑब्जेक्ट, जो उपलब्ध होने पर सक्रिय उपयोगकर्ता को दिखाता है (सुरक्षा पाबंदियों के जटिल सेट के आधार पर). [e-mail]

बदलाव करें (आसान और इंस्टॉल किया जा सकता है)
authMode	ScriptApp.AuthMode Enum से कोई वैल्यू. LIMITED
oldValue	बदलाव से पहले की सेल की वैल्यू, अगर कोई हो. यह वैल्यू सिर्फ़ तब उपलब्ध होती है, जब बदली गई रेंज में सिर्फ़ एक सेल हो. अगर सेल में पहले से कोई कॉन्टेंट नहीं था, तो वैल्यू के बारे में नहीं बताया जाएगा. 1234
range	Range ऑब्जेक्ट, जो सेल या सेल की वह रेंज दिखाता है जिसमें बदलाव किया गया है. Range
source	Spreadsheet ऑब्जेक्ट, वह Google Sheets फ़ाइल दिखाता है जिससे स्क्रिप्ट जुड़ी हुई है. Spreadsheet
triggerUid	उस ट्रिगर का आईडी जिसने यह इवेंट बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर). 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 Docs इवेंट

ट्रिगर की मदद से, Google Docs को उपयोगकर्ता के दस्तावेज़ खोलने पर जवाब देने की अनुमति मिलती है.

ओपन (आसान और इंस्टॉल किया जा सकता है)
authMode	ScriptApp.AuthMode Enum से कोई वैल्यू. LIMITED
source	Document ऑब्जेक्ट, वह Google Docs फ़ाइल दिखाता है जिससे स्क्रिप्ट जुड़ी है. Document
triggerUid	उस ट्रिगर का आईडी जिसने यह इवेंट बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर). 4034124084959907503
user	User ऑब्जेक्ट, जो उपलब्ध होने पर सक्रिय उपयोगकर्ता को दिखाता है (सुरक्षा पाबंदियों के जटिल सेट के आधार पर). [e-mail]

Google Slides इवेंट

ट्रिगर की मदद से, Google Slides को उपयोगकर्ता के किसी प्रज़ेंटेशन को खोलने पर जवाब देने की सुविधा मिलती है.

ओपन (आसान)
authMode	ScriptApp.AuthMode Enum से कोई वैल्यू. LIMITED
source	Presentation ऑब्जेक्ट, Google Slides की वह फ़ाइल दिखाता है जिससे स्क्रिप्ट जुड़ी है. Presentation
user	User ऑब्जेक्ट, जो उपलब्ध होने पर सक्रिय उपयोगकर्ता को दिखाता है (सुरक्षा पाबंदियों के जटिल सेट के आधार पर). [e-mail]

Google Forms के इवेंट

जब कोई उपयोगकर्ता किसी फ़ॉर्म में बदलाव करता है या जवाब सबमिट करता है, तब Google फ़ॉर्म के लिए बने ट्रिगर की मदद से स्क्रिप्ट को जवाब देने की सुविधा मिलती है.

ओपन * (आसान और इंस्टॉल किया जा सकता है)
authMode	ScriptApp.AuthMode Enum से कोई वैल्यू. LIMITED
source	Form ऑब्जेक्ट, Google Forms की वह फ़ाइल दिखाता है जिससे स्क्रिप्ट जुड़ी है. Form
triggerUid	उस ट्रिगर का आईडी जिसने यह इवेंट बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर). 4034124084959907503
user	User ऑब्जेक्ट, जो उपलब्ध होने पर सक्रिय उपयोगकर्ता को दिखाता है (सुरक्षा पाबंदियों के जटिल सेट के आधार पर). [e-mail]

* यह इवेंट तब नहीं होता है, जब उपयोगकर्ता जवाब देने के लिए फ़ॉर्म खोलता है. यह तब होता है, जब कोई एडिटर बदलाव करने के लिए फ़ॉर्म खोलता है.

फ़ॉर्म सबमिट (इंस्टॉल किया जा सकता है)
चेतावनी: FormTriggerBuilder के साथ इस फ़ॉर्म सबमिट ट्रिगर का इस्तेमाल करना न भूलें.
authMode	ScriptApp.AuthMode Enum से कोई वैल्यू. FULL
response	FormResponse ऑब्जेक्ट, जो फ़ॉर्म में उपयोगकर्ता का जवाब दिखाता है. FormResponse
source	Form ऑब्जेक्ट, Google Forms की वह फ़ाइल दिखाता है जिससे स्क्रिप्ट जुड़ी है. Form
triggerUid	उस ट्रिगर का आईडी जिसने यह इवेंट बनाया. 4034124084959907503

Google Calendar इवेंट

जब उपयोगकर्ता के कैलेंडर इवेंट अपडेट किए जाते हैं (बनाए जाते हैं, बदले जाते हैं या मिटाए जाते हैं), तो कैलेंडर ट्रिगर सक्रिय हो जाता है.

इन ट्रिगर से आपको यह नहीं पता चलता कि किस इवेंट में बदलाव हुआ है या वह कैसे बदला है. इसके बजाय, वे यह बताते हैं कि कैलेंडर में हाल में किए गए बदलावों को पिक अप करने के लिए, आपके कोड को इन्क्रीमेंटल सिंक ऑपरेशन करना होगा. इस प्रोसेस की पूरी जानकारी के लिए, Calendar API के लिए संसाधनों को सिंक करने से जुड़ी गाइड देखें.

Apps Script में Calendar के साथ सिंक करने के लिए, नीचे दिया गया तरीका अपनाएं:

1. स्क्रिप्ट प्रोजेक्ट के लिए, Calendar की बेहतर सेवा चालू करें. इस वर्कफ़्लो के लिए, पहले से मौजूद कैलेंडर सेवा काफ़ी नहीं है.
2. तय करें कि कौन-कौनसे कैलेंडर सिंक होने चाहिए. ऐसे हर कैलेंडर के लिए, Calendar की बेहतर सेवा के Events.list() तरीके का इस्तेमाल करके, शुरुआती सिंक करें.
3. शुरुआती सिंक का नतीजा उस कैलेंडर के लिए एक nextSyncToken दिखाता है. इस टोकन को सेव करें, ताकि इसे बाद में इस्तेमाल किया जा सके.
4. जब Apps Script EventUpdated ट्रिगर, कैलेंडर इवेंट में होने वाले बदलाव की जानकारी देता है, तो सेव किए गए nextSyncToken का इस्तेमाल करके, उस कैलेंडर के लिए इंक्रीमेंटल सिंक करें जिस पर असर पड़ा है. यह ज़रूरी है कि यह एक दूसरा Events.list() अनुरोध है, लेकिन nextSyncToken देने से, सिर्फ़ उन इवेंट के लिए रिस्पॉन्स सीमित हो जाता है जो पिछली बार सिंक होने के बाद हुए हैं.
5. किन इवेंट को अपडेट किया गया है, यह जानने के लिए सिंक के रिस्पॉन्स की जांच करें और अपने कोड से सही तरीके से काम करें. उदाहरण के लिए, बदलाव को लॉग किया जा सकता है, स्प्रेडशीट अपडेट की जा सकती है, ईमेल सूचनाएं भेजी जा सकती हैं या दूसरी कार्रवाइयां की जा सकती हैं.
6. आपने उस कैलेंडर के लिए जो nextSyncToken सेव किया है उसे अपडेट करें. साथ ही, सिंक करने के बढ़ते हुए अनुरोध से मिले कन्वर्ज़न को भी अपडेट करें. इससे अगले सिंक ऑपरेशन के लिए, सिर्फ़ सबसे हाल ही के बदलाव को लागू करना पड़ता है.

चेतावनी: कभी-कभी सर्वर, सिंक टोकन को अमान्य कर देता है. इसकी वजह से410 गड़बड़ी होती है. ऐसा होने पर, आपके कोड को पूरी तरह सिंक करना चाहिए. साथ ही, कैलेंडर में सेव किए गए सभी डेटा और टोकन को बदलना चाहिए.

EventUpdated (इंस्टॉल किया जा सकता है)
authMode	ScriptApp.AuthMode enum से कोई वैल्यू. FULL
calendarId	उस कैलेंडर का स्ट्रिंग आईडी जिसमें इवेंट अपडेट हुआ. [e-mail]
triggerUid	उस ट्रिगर का आईडी जिसने यह इवेंट बनाया. 4034124084959907503

Google Workspace ऐड-ऑन इवेंट

जब कोई उपयोगकर्ता ऐड-ऑन इंस्टॉल करता है, तब onInstall() ट्रिगर अपने-आप चलता है.

इंस्टॉल करें (आसान)
authMode	ScriptApp.AuthMode Enum से कोई वैल्यू. FULL

Google Chat ऐप्लिकेशन के इवेंट

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