आसान ट्रिगर और
इंस्टॉल किए जा सकने वाले ट्रिगर की मदद से, 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 फ़ॉर्म के लिए बने ट्रिगर की मदद से स्क्रिप्ट को जवाब देने की सुविधा मिलती है.
ओपन* (आसान और इंस्टॉल किया जा सकता है) |
|
---|---|
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 |