आसान ट्रिगर और
इंस्टॉल किए जा सकने वाले ट्रिगर की मदद से, कोई खास इवेंट होने पर 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());
}
यह पेज अलग-अलग तरह के ट्रिगर के लिए इवेंट ऑब्जेक्ट में मौजूद फ़ील्ड के बारे में जानकारी देता है.
Google Sheets इवेंट
Google Sheets से जुड़े कई ट्रिगर, स्क्रिप्ट को स्प्रेडशीट में उपयोगकर्ता की कार्रवाइयों का जवाब देने की अनुमति देते हैं.
खुला है(आसान और इंस्टॉल किया जा सकता है) |
|
---|---|
authMode |
LIMITED |
source |
Spreadsheet |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर). 4034124084959907503 |
user |
amin@example.com |
बदलें(इंस्टॉल किया जा सकता है) |
|
---|---|
authMode |
FULL |
changeType |
बदलाव किस तरह का है ( INSERT_ROW |
source |
Spreadsheet |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है. 4034124084959907503 |
user |
amin@example.com |
बदलाव करें(आसान और इंस्टॉल किया जा सकता है) |
|
---|---|
authMode |
LIMITED |
oldValue |
अगर कोई है, तो बदलाव से पहले की सेल की वैल्यू. सिर्फ़ तब उपलब्ध होती है, जब बदली गई रेंज एक ही सेल हो. अगर सेल में पहले से कोई कॉन्टेंट नहीं है, तो वैल्यू तय नहीं होगी. 1234 |
range |
Range |
source |
Spreadsheet |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर). 4034124084959907503 |
user |
amin@example.com |
value |
बदलाव के बाद सेल की नई वैल्यू. बदलाव की गई रेंज सिर्फ़ एक सेल होने पर ही उपलब्ध होती है. 10 |
फ़ॉर्म सबमिट(इंस्टॉल किया जा सकता है) |
|
---|---|
authMode |
FULL |
namedValues |
एक ऑब्जेक्ट, जिसमें सवाल के नाम और फ़ॉर्म सबमिशन की वैल्यू शामिल होती हैं. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] } |
range |
Range |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है. 4034124084959907503 |
values |
कलेक्शन में मौजूद वैल्यू उसी क्रम में हैं जिस क्रम में वे स्प्रेडशीट में दिखती हैं. ['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill', '28', 'Susan', '25'] |
Google Docs से जुड़े इवेंट
जब कोई उपयोगकर्ता दस्तावेज़ खोलता है, तो ट्रिगर Google Docs को जवाब देने की अनुमति देते हैं.
खुला है(आसान और इंस्टॉल किया जा सकता है) |
|
---|---|
authMode |
LIMITED |
source |
Document |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर). 4034124084959907503 |
user |
amin@example.com |
Google Slides इवेंट
जब कोई उपयोगकर्ता प्रज़ेंटेशन खोलता है, तो ट्रिगर Google Slides को जवाब देने की अनुमति देता है.
खुला है(आसान) |
|
---|---|
authMode |
LIMITED |
source |
Presentation |
user |
amin@example.com |
Google Forms के इवेंट
जब कोई उपयोगकर्ता फ़ॉर्म में बदलाव करता है या जवाब सबमिट करता है, तो Google Forms के खास ट्रिगर, स्क्रिप्ट को जवाब देने देते हैं.
खुला है* (आसान और इंस्टॉल किए जा सकते हैं |
|
---|---|
authMode |
LIMITED |
source |
Form |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर). 4034124084959907503 |
user |
amin@example.com |
* यह इवेंट तब नहीं होता जब कोई उपयोगकर्ता जवाब देने के लिए कोई फ़ॉर्म खोलता है, बल्कि तब होता है जब कोई संपादक फ़ॉर्म में बदलाव करने के लिए उसे खोलता है.
फ़ॉर्म सबमिट(इंस्टॉल किया जा सकता है) |
|
---|---|
authMode |
FULL |
response |
FormResponse |
source |
Form |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है. 4034124084959907503 |
Google Calendar इवेंट
कैलेंडर ट्रिगर तब सक्रिय होता है, जब किसी उपयोगकर्ता के कैलेंडर इवेंट अपडेट किए जाते हैं (बनाए जाते हैं, उनमें बदलाव किया जाता है या उन्हें मिटाया जाता है).
इन ट्रिगर से आपको यह पता नहीं चलता कि कौनसा इवेंट बदल गया है या वह कैसे बदला है. इसके बजाय, वे दिखाते हैं कि आपके कोड को कैलेंडर में हाल ही में किए गए बदलावों को इस्तेमाल करने के लिए एक इंक्रीमेंटल सिंक ऑपरेशन करना होगा. इस प्रोसेस की पूरी जानकारी के लिए, Calendar API की सिंक करने के रिसॉर्स की गाइड देखें.
Apps Script में Calendar को सिंक करने के लिए, यह तरीका अपनाएं:
- स्क्रिप्ट प्रोजेक्ट के लिए Calendar की बेहतर सेवा चालू करें. पहले से मौजूद Calendar की सेवा, इस वर्कफ़्लो के लिए काफ़ी नहीं है.
- निर्धारित करें कि कौन से कैलेंडर सिंक किए जाने चाहिए. ऐसे हर कैलेंडर के लिए, कैलेंडर की बेहतर सेवा के Events.list() वाले तरीके का इस्तेमाल करके, शुरुआती सिंक कार्रवाई करें.
- शुरुआती सिंक का नतीजा, उस कैलेंडर के लिए
nextSyncToken
दिखाता है. इस टोकन को बाद में इस्तेमाल करने के लिए सेव करें. - जब Apps Script
EventUpdated
ट्रिगर से कैलेंडर इवेंट में होने वाले बदलाव के बारे में पता चलता है, तो सेव किए गएnextSyncToken
का इस्तेमाल करके, उस कैलेंडर के लिए इंक्रीमेंटल सिंक करें जिस पर असर पड़ा है. यह असल में एक और Events.list() अनुरोध है, लेकिनnextSyncToken
देने से सिर्फ़ उन इवेंट का रिस्पॉन्स मिलता है जो पिछली बार सिंक होने के बाद से बदले हैं. - कौनसे इवेंट अपडेट हुए हैं, यह जानने के लिए सिंक के रिस्पॉन्स की जांच करें और अपने कोड को सही तरीके से रिस्पॉन्स दें. उदाहरण के लिए, आप बदलाव लॉग कर सकते हैं, स्प्रेडशीट को अपडेट कर सकते हैं, ईमेल सूचनाएं भेज सकते हैं या दूसरी कार्रवाइयां कर सकते हैं.
- उस कैलेंडर के लिए सेव किए गए
nextSyncToken
को अपडेट करें जो सिंक करने के इंक्रीमेंटल (बढ़ने वाले) अनुरोध से मिला है. इससे अगली सिंक कार्रवाई, सिर्फ़ सबसे नए बदलाव करने के लिए मजबूर हो जाती है.
EventUpdated(इंस्टॉल किया जा सकता है) |
|
---|---|
authMode |
FULL |
calendarId |
उस कैलेंडर का स्ट्रिंग आईडी जिसमें इवेंट अपडेट हुआ. susan@example.com |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है. 4034124084959907503 |
Google Workspace ऐड-ऑन इवेंट
जब कोई उपयोगकर्ता ऐड-ऑन इंस्टॉल करता है, तो onInstall()
ट्रिगर अपने-आप चालू हो जाता है.
इंस्टॉल करें(आसान) |
|
---|---|
authMode |
FULL |
Google Chat ऐप्लिकेशन के इवेंट
Google Chat में इवेंट के ऑब्जेक्ट के बारे में जानने के लिए, Google Chat ऐप्लिकेशन से इंटरैक्शन पाना और उनका जवाब देना देखें.
टाइम-ड्रिवन इवेंट
समय पर चलने वाले ट्रिगर (जिसे क्लॉक ट्रिगर भी कहा जाता है) स्क्रिप्ट को किसी खास समय पर या बार-बार चलने वाले इंटरवल पर लागू करने देते हैं.
समय के हिसाब से (इंस्टॉल किया जा सकता है) | |
---|---|
authMode |
FULL |
day-of-month |
इस प्रॉपर्टी के नाम में डैश हैं, इसलिए इसे डॉट नोटेशन के बजाय
31 |
day-of-week |
इस प्रॉपर्टी के नाम में डैश हैं, इसलिए इसे डॉट नोटेशन के बजाय
7 |
hour |
23 |
minute |
59 |
month |
12 |
second |
59 |
timezone |
टाइम ज़ोन. UTC |
triggerUid |
उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है. 4034124084959907503 |
week-of-year |
इस प्रॉपर्टी के नाम में डैश हैं, इसलिए इसे डॉट नोटेशन के बजाय
52 |
year |
यह वर्ष. 2015 |