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

आसान ट्रिगर और इंस्टॉल किए जा सकने वाले ट्रिगर की मदद से, कोई खास इवेंट होने पर 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

ScriptApp.AuthMode ईनम से कोई वैल्यू.

LIMITED
source

Spreadsheet ऑब्जेक्ट, जो Google Sheets की उस फ़ाइल को दिखाता है जिससे स्क्रिप्ट बाउंड होती है.

Spreadsheet
triggerUid

उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर).

4034124084959907503
user

User ऑब्जेक्ट, अगर उपलब्ध हो, तो सक्रिय उपयोगकर्ता की जानकारी देता है (सुरक्षा से जुड़ी पाबंदियों के जटिल सेट के आधार पर).

amin@example.com

बदलें

(इंस्टॉल किया जा सकता है)
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 ऑब्जेक्ट, अगर उपलब्ध हो, तो सक्रिय उपयोगकर्ता की जानकारी देता है (सुरक्षा से जुड़ी पाबंदियों के जटिल सेट के आधार पर).

amin@example.com

बदलाव करें

(आसान और इंस्टॉल किया जा सकता है)
authMode

ScriptApp.AuthMode ईनम से कोई वैल्यू.

LIMITED
oldValue

अगर कोई है, तो बदलाव से पहले की सेल की वैल्यू. सिर्फ़ तब उपलब्ध होती है, जब बदली गई रेंज एक ही सेल हो. अगर सेल में पहले से कोई कॉन्टेंट नहीं है, तो वैल्यू तय नहीं होगी.

1234
range

Range ऑब्जेक्ट, जो बदलाव किए गए सेल या सेल की रेंज को दिखाता है.

Range
source

Spreadsheet ऑब्जेक्ट, जो Google Sheets की उस फ़ाइल को दिखाता है जिससे स्क्रिप्ट बाउंड होती है.

Spreadsheet
triggerUid

उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर).

4034124084959907503
user

User ऑब्जेक्ट, अगर उपलब्ध हो, तो सक्रिय उपयोगकर्ता की जानकारी देता है (सुरक्षा से जुड़ी पाबंदियों के जटिल सेट के आधार पर).

amin@example.com
value

बदलाव के बाद सेल की नई वैल्यू. बदलाव की गई रेंज सिर्फ़ एक सेल होने पर ही उपलब्ध होती है.

10

फ़ॉर्म सबमिट

(इंस्टॉल किया जा सकता है)
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', 'amin@example.com', 'Bob', '27', 'Bill',
'28', 'Susan', '25']

Google Docs से जुड़े इवेंट

जब कोई उपयोगकर्ता दस्तावेज़ खोलता है, तो ट्रिगर Google Docs को जवाब देने की अनुमति देते हैं.

खुला है

(आसान और इंस्टॉल किया जा सकता है)
authMode

ScriptApp.AuthMode ईनम से कोई वैल्यू.

LIMITED
source

Document ऑब्जेक्ट, जो उस Google Docs फ़ाइल को दिखाता है जिससे स्क्रिप्ट बाउंड होती है.

Document
triggerUid

उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर).

4034124084959907503
user

User ऑब्जेक्ट, अगर उपलब्ध हो, तो सक्रिय उपयोगकर्ता की जानकारी देता है (सुरक्षा से जुड़ी पाबंदियों के जटिल सेट के आधार पर).

amin@example.com

Google Slides इवेंट

जब कोई उपयोगकर्ता प्रज़ेंटेशन खोलता है, तो ट्रिगर Google Slides को जवाब देने की अनुमति देता है.

खुला है

(आसान)
authMode

ScriptApp.AuthMode ईनम से कोई वैल्यू.

LIMITED
source

Presentation ऑब्जेक्ट, जो Google Slides की उस फ़ाइल को दिखाता है जिससे स्क्रिप्ट बाउंड होती है.

Presentation
user

User ऑब्जेक्ट, अगर उपलब्ध हो, तो सक्रिय उपयोगकर्ता की जानकारी देता है (सुरक्षा से जुड़ी पाबंदियों के जटिल सेट के आधार पर).

amin@example.com

Google Forms के इवेंट

जब कोई उपयोगकर्ता फ़ॉर्म में बदलाव करता है या जवाब सबमिट करता है, तो Google Forms के खास ट्रिगर, स्क्रिप्ट को जवाब देने देते हैं.

खुला है

* (आसान और इंस्टॉल किए जा सकते हैं
authMode

ScriptApp.AuthMode ईनम से कोई वैल्यू.

LIMITED
source

Form ऑब्जेक्ट, जो Google Forms की उस फ़ाइल को दिखाता है जिससे स्क्रिप्ट बाउंड है.

Form
triggerUid

उस ट्रिगर का आईडी जिसने इस इवेंट को बनाया है (सिर्फ़ इंस्टॉल किए जा सकने वाले ट्रिगर).

4034124084959907503
user

User ऑब्जेक्ट, अगर उपलब्ध हो, तो सक्रिय उपयोगकर्ता की जानकारी देता है (सुरक्षा से जुड़ी पाबंदियों के जटिल सेट के आधार पर).

amin@example.com

* यह इवेंट तब नहीं होता जब कोई उपयोगकर्ता जवाब देने के लिए कोई फ़ॉर्म खोलता है, बल्कि तब होता है जब कोई संपादक फ़ॉर्म में बदलाव करने के लिए उसे खोलता है.

फ़ॉर्म सबमिट

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

EventUpdated

(इंस्टॉल किया जा सकता है)
authMode

ScriptApp.AuthMode ईनम से कोई वैल्यू.

FULL
calendarId

उस कैलेंडर का स्ट्रिंग आईडी जिसमें इवेंट अपडेट हुआ.

susan@example.com
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