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

सिंपल ट्रिगर और इंस्टॉल किए जा सकने वाले ट्रिगर की मदद से, 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 के लिए उपलब्ध अलग-अलग ट्रिगर की मदद से, स्क्रिप्ट को स्प्रेडशीट में उपयोगकर्ता की कार्रवाइयों का जवाब देने की अनुमति मिलती है.

खोलें (simple and installable)
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]

बदलाव करें (simple and installable)
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 को यह पता चलता है कि उपयोगकर्ता ने कोई दस्तावेज़ खोला है.

खोलें (simple and installable)
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 Forms के लिए उपलब्ध ट्रिगर की मदद से, स्क्रिप्ट तब काम करती हैं, जब कोई उपयोगकर्ता किसी फ़ॉर्म में बदलाव करता है या कोई जवाब सबमिट करता है.

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