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

आसान ट्रिगर और इंस्टॉल किए जा सकने वाले ट्रिगर की मदद से Apps Script को कोई खास इवेंट होने पर फ़ंक्शन को अपने-आप चलाएं. जब कोई ट्रिगर सक्रिय होता है, Apps Script, फ़ंक्शन को इवेंट ऑब्जेक्ट को तर्क के तौर पर पास करती है. आम तौर पर, इसे e. इवेंट ऑब्जेक्ट में उस कॉन्टेक्स्ट के बारे में जानकारी होती है जिसकी वजह से ट्रिगर होना चाहिए. उदाहरण के लिए, नीचे दिया गया सैंपल कोड, एक सामान्य onEdit(e) दिखाता है एक Google Sheets स्क्रिप्ट के लिए ट्रिगर करता है, जो इवेंट ऑब्जेक्ट का इस्तेमाल करके यह तय करता है कि सेल में बदलाव किया गया.

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 दस्तावेज़ फ़ाइल का प्रतिनिधित्व कर रहा है जिससे स्क्रिप्ट बाउंड है. 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 API.

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

1. इसके लिए Calendar की बेहतर सेवा चालू करें स्क्रिप्ट प्रोजेक्ट. बिल्ट-इन Calendar सेवा, दी गई जानकारी के लिए काफ़ी नहीं है कर सकते हैं.
2. निर्धारित करें कि कौन से कैलेंडर सिंक किए जाने चाहिए. ऐसे हर कैलेंडर के लिए, शुरुआती सिंक करें आप Google की बेहतर सेवा का इस्तेमाल कर रहे हैं 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 ईनम से कोई वैल्यू. 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