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

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

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

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

Google Slides इवेंट

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

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

Google Forms इवेंट

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

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

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

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

Google Calendar इवेंट

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

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

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

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

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

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

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

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

इंस्टॉल करें (सामान्य)
authMode	ScriptApp.AuthMode एनम से मिली वैल्यू. FULL

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

Google Chat में इवेंट ऑब्जेक्ट के बारे में जानने के लिए, Google Chat ऐप्लिकेशन से इंटरैक्शन पाने और उनका जवाब देने का तरीका लेख पढ़ें.

समय के हिसाब से होने वाले इवेंट

समय के हिसाब से ट्रिगर (इन्हें घड़ी के ट्रिगर भी कहा जाता है) की मदद से, स्क्रिप्ट किसी खास समय पर या बार-बार होने वाले इंटरवल पर लागू की जा सकती हैं.

समय के हिसाब से (इंस्टॉल किया जा सकता है)
authMode	ScriptApp.AuthMode एनम से मिली वैल्यू. 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