आसान ट्रिगर और
इंस्टॉल किए जा सकने वाले ट्रिगर की मदद से 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());
}
यह पेज इवेंट ऑब्जेक्ट में अलग-अलग तरह के इवेंट के फ़ील्ड की जानकारी देता है ट्रिगर हैं.
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 सेवा, दी गई जानकारी के लिए काफ़ी नहीं है कर सकते हैं.
- निर्धारित करें कि कौन से कैलेंडर सिंक किए जाने चाहिए. ऐसे हर कैलेंडर के लिए, शुरुआती सिंक करें आप Google की बेहतर सेवा का इस्तेमाल कर रहे हैं 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 |