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

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