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

इस पेज पर, Google Workspace ऐड-ऑन के इवेंट ऑब्जेक्ट के स्ट्रक्चर के बारे में बताया गया है.

इवेंट ऑब्जेक्ट, JSON स्ट्रक्चर होते हैं. ये अपने-आप बनते हैं और इन्हें पैरामीटर के तौर पर पास किया जाता है. ऐसा तब होता है, जब कोई उपयोगकर्ता ऐड-ऑन से इंटरैक्ट करता है. इन पैरामीटर का इस्तेमाल, ट्रिगर या कॉलबैक फ़ंक्शन के लिए किया जाता है. इवेंट ऑब्जेक्ट, ऐड-ऑन के सर्वर-साइड कॉलबैक फ़ंक्शन को होस्ट ऐप्लिकेशन और मौजूदा कॉन्टेक्स्ट के बारे में क्लाइंट-साइड की जानकारी देते हैं.

Google Workspace के ऐड-ऑन, इवेंट ऑब्जेक्ट का इस्तेमाल इन जगहों पर करते हैं:

  • होम पेज के ट्रिगर. होम पेज ट्रिगर फ़ंक्शन के फ़ायर होने पर, आपके तय किए गए हर homepageTrigger फ़ंक्शन को इवेंट ऑब्जेक्ट अपने-आप मिल जाता है. इस ऑब्जेक्ट का इस्तेमाल, होम पेज ट्रिगर करने वाले फ़ंक्शन में किया जा सकता है. इससे ऐक्टिव होस्ट ऐप्लिकेशन, क्लाइंट का प्लैटफ़ॉर्म, उपयोगकर्ता की स्थान-भाषा, और अन्य जानकारी का पता लगाया जा सकता है.

    होम पेज के ट्रिगर फ़ायर होने पर बनाए गए इवेंट ऑब्जेक्ट में, अन्य मामलों में शामिल सभी फ़ील्ड नहीं होते. इनमें विजेट और कॉन्टेक्स्ट के हिसाब से जानकारी देने वाले फ़ील्ड शामिल नहीं होते.

  • कॉन्टेक्स्ट के हिसाब से ट्रिगर. हर होस्ट ऐप्लिकेशन, कॉन्टेक्स्ट के हिसाब से ट्रिगर का एक अलग सेट उपलब्ध कराता है. ये ट्रिगर तब चालू होते हैं, जब उपयोगकर्ता किसी खास कॉन्टेक्स्ट में प्रवेश करता है:

    कॉन्टेक्स्ट के हिसाब से ट्रिगर होने पर, होस्ट ऐप्लिकेशन, ऐड-ऑन मेनिफ़ेस्ट में शामिल किए गए runFunction को कॉल करता है. साथ ही, उसे पैरामीटर के तौर पर इवेंट ऑब्जेक्ट पास करता है. कॉन्टेक्स्ट के हिसाब से ट्रिगर होने पर बनाए गए इवेंट ऑब्जेक्ट में, होम पेज के ट्रिगर इवेंट ऑब्जेक्ट में शामिल सभी फ़ील्ड होते हैं. साथ ही, इसमें कॉन्टेक्स्ट के हिसाब से जानकारी देने वाले फ़ील्ड भी होते हैं.

  • विजेट की कार्रवाइयां. इवेंट ऑब्जेक्ट, विजेट के साथ इंटरैक्ट करने की सुविधा देते हैं. इसके लिए, Gmail ऐड-ऑन में इस्तेमाल होने वाले ऐक्शन मॉडल का इस्तेमाल किया जाता है. Google Workspace ऐड-ऑन, एक ही विजेट हैंडलर फ़ंक्शन, Action ऑब्जेक्ट, और ऐक्शन रिस्पॉन्स का इस्तेमाल करते हैं. Google Workspace ऐड-ऑन में, ऐक्शन इवेंट ऑब्जेक्ट में ज़्यादा जानकारी शामिल होती है. इस जानकारी के आधार पर, कॉलबैक फ़ंक्शन काम कर सकता है.

    विजेट ऐक्शन से बनाए गए इवेंट ऑब्जेक्ट में, कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाले इवेंट ऑब्जेक्ट में शामिल सभी फ़ील्ड होते हैं. साथ ही, इनमें ऐसे फ़ील्ड भी होते हैं जिनमें विजेट की जानकारी होती है.

  • लिंक ट्रिगर की झलक देखें. Google Docs, Sheets, और Slides में, तीसरे पक्ष की सेवाओं के लिए लिंक की झलक कॉन्फ़िगर की जा सकती हैं. इसके लिए, यूआरएल के खास पैटर्न का इस्तेमाल किया जाता है. जब उपयोगकर्ता, पैटर्न से मेल खाने वाले किसी लिंक से इंटरैक्ट करते हैं, तो linkPreviewTriggers ट्रिगर होता है. साथ ही, लिंक वाला इवेंट ऑब्जेक्ट, ट्रिगर के कॉलबैक फ़ंक्शन को पास किया जाता है. आपका ऐड-ऑन इस इवेंट ऑब्जेक्ट का इस्तेमाल करके, स्मार्ट चिप और कार्ड बना सकता है. इससे होस्ट ऐप्लिकेशन में मौजूद लिंक के बारे में जानकारी मिलती है. विजेट ऐक्शन भी बनाए जा सकते हैं, ताकि लोग झलक वाले कार्ड और उसके कॉन्टेंट के साथ इंटरैक्ट कर सकें.

  • Google Chat ऐप्लिकेशन के ट्रिगर. Google Chat में, आपका ऐड-ऑन लोगों को Chat ऐप्लिकेशन के तौर पर दिखता है. लोग इसे स्पेस में जोड़कर, मैसेज भेजकर, स्लैश कमांड का इस्तेमाल करके, और अन्य तरीकों से इसके साथ इंटरैक्ट कर सकते हैं. इंटरैक्टिव सुविधाएं बनाने के लिए, Chat ऐप्लिकेशन के अलग-अलग ट्रिगर सेट अप किए जाते हैं और उनका इस्तेमाल किया जाता है. हर ट्रिगर, अलग इवेंट ऑब्जेक्ट पेलोड भेजता है. इससे आपको हर तरह के इंटरैक्शन को प्रोसेस करने या उनका जवाब देने में मदद मिलती है.

इवेंट ऑब्जेक्ट का स्ट्रक्चर

यहां दी गई टेबल में, Google Workspace ऐड-ऑन के इवेंट ऑब्जेक्ट का टॉप-लेवल स्ट्रक्चर बताया गया है. इस स्ट्रक्चर में, होस्ट से जुड़ी जानकारी के लिए commonEventObject टॉप-लेवल फ़ील्ड शामिल होता है. हर इवेंट ऑब्जेक्ट में, होस्ट के हिसाब से टॉप-लेवल के इन फ़ील्ड में से कोई एक फ़ील्ड भी हो सकता है. यह फ़ील्ड, चालू होस्ट ऐप्लिकेशन के हिसाब से तय होता है: gmailEventObject, calendarEventObject या driveEventObject.

पिछले वर्शन के साथ काम करने के लिए, Google Workspace ऐड-ऑन के इवेंट ऑब्जेक्ट में वे ओरिजनल फ़ील्ड शामिल होते हैं जिनका इस्तेमाल Gmail ऐड-ऑन के ऐक्शन इवेंट ऑब्जेक्ट में किया जाता है. ये फ़ील्ड, "Gmail के ओरिजनल ऐड-ऑन फ़ील्ड" में मौजूद हैं और commonEventObject का हिस्सा नहीं हैं.

Gmail के ओरिजनल ऐड-ऑन के फ़ील्ड अब काम नहीं करते. Google Workspace ऐड-ऑन डेवलप करते समय या माइग्रेट करते समय, इवेंट ऑब्जेक्ट के नए स्ट्रक्चर का इस्तेमाल करें. ऐसा हो सकता है कि आने वाले समय में होने वाले अपडेट में इन फ़ील्ड को हटा दिया जाए.

इवेंट ऑब्जेक्ट
eventObject.commonEventObject Common fields object
यह एक ऐसा ऑब्जेक्ट होता है जिसमें सभी इवेंट ऑब्जेक्ट के लिए सामान्य जानकारी होती है. भले ही, होस्ट ऐप्लिकेशन कोई भी हो.
eventObject.calendar Calendar event object
यह जानकारी सिर्फ़ तब मौजूद होती है, जब कॉल करने वाला होस्ट Google Calendar हो. कैलेंडर और इवेंट की जानकारी वाला ऑब्जेक्ट.
eventObject.chat Chat event object
यह जानकारी सिर्फ़ तब दिखती है, जब कॉल करने वाला होस्ट Google Chat हो. Chat की जानकारी देने वाला ऑब्जेक्ट.
eventObject.drive Drive event object
यह सिर्फ़ तब मौजूद होता है, जब कॉल करने वाला होस्ट Google Drive हो. Drive के बारे में जानकारी देने वाला ऑब्जेक्ट.
eventObject.gmail Gmail event object
यह जानकारी सिर्फ़ तब दिखती है, जब कॉल करने वाला होस्ट Gmail हो. Gmail खाते की जानकारी देने वाला ऑब्जेक्ट.
eventObject.docs Docs event object
यह सिर्फ़ तब मौजूद होता है, जब कॉल करने वाला होस्ट Google Docs हो. Docs की जानकारी देने वाला ऑब्जेक्ट.
eventObject.sheets Sheets event object
यह सिर्फ़ तब मौजूद होता है, जब कॉल करने वाला होस्ट Google Sheets हो. Sheets की जानकारी देने वाला ऑब्जेक्ट.
eventObject.slides Slides event object
यह सिर्फ़ तब मौजूद होता है, जब कॉल करने वाला होस्ट Google Slides हो. स्लाइड की जानकारी देने वाला ऑब्जेक्ट.
Gmail के ऐड-ऑन के ओरिजनल फ़ील्ड
eventObject.messageMetadata.accessToken string
अब सेवा में नहीं है. ऐक्सेस टोकन. इसका इस्तेमाल, Gmail ऐड-ऑन के कुछ समय तक मान्य रहने वाले स्कोप का इस्तेमाल करके, उपयोगकर्ता के डेटा का ऐक्सेस चालू करने के लिए किया जा सकता है.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.gmail.accessToken फ़ील्ड में देखें.

eventObject.messageMetadata.messageId string
अब सेवा में नहीं है. Gmail के यूज़र इंटरफ़ेस (यूआई) में खुली थ्रेड का मैसेज आईडी.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.gmail.messageId फ़ील्ड में देखें.

eventObject.clientPlatform string
अब सेवा में नहीं है. इससे पता चलता है कि इवेंट कहां से शुरू हुआ (वेब, iOS या Android).

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.commonEventObject.platform फ़ील्ड में देखें.

eventObject.formInput object
अब सेवा में नहीं है. कार्ड में मौजूद सभी फ़ॉर्म विजेट की मौजूदा वैल्यू का मैप. इसमें हर विजेट के लिए एक वैल्यू होती है. कुंजियां, विजेट से जुड़े स्ट्रिंग आईडी होती हैं और वैल्यू, स्ट्रिंग होती हैं. इवेंट ऑब्जेक्ट, formInput को इस तरह से उपलब्ध कराता है कि जब आपको टेक्स्ट इनपुट और स्विच जैसे कई विजेट से डेटा पढ़ना हो, तो आपको आसानी हो. एक से ज़्यादा वैल्यू वाले विजेट, जैसे कि चेकबॉक्स के लिए, हर वैल्यू को formInputs से पढ़ें.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.commonEventObject.formInputs फ़ील्ड में देखें. एक वैल्यू वाले विजेट को एक एलिमेंट वाले ऐरे के तौर पर दिखाया जाता है.

eventObject.formInputs object
अब सेवा में नहीं है. कार्ड में मौजूद विजेट की मौजूदा वैल्यू का मैप. इसे स्ट्रिंग की सूचियों के तौर पर दिखाया जाता है. कुंजियां, विजेट से जुड़े स्ट्रिंग आईडी होती हैं. सिंगल वैल्यू वाले विजेट के लिए, वैल्यू को सिंगल-एलिमेंट ऐरे में दिखाया जाता है. एक से ज़्यादा वैल्यू वाले विजेट, जैसे कि चेकबॉक्स ग्रुप के लिए, सभी वैल्यू को सूची में दिखाया जाता है.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.commonEventObject.formInputs फ़ील्ड में देखें.

eventObject.parameters object
अब सेवा में नहीं है. Action.setParameters का इस्तेमाल करके, Action को दिए गए किसी भी अतिरिक्त पैरामीटर का मैप. मैप की कुंजियां और वैल्यू, स्ट्रिंग होती हैं.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.commonEventObject.parameters फ़ील्ड में देखें.

eventObject.userCountry string
अब इसका इस्तेमाल नहीं किया जा सकता और यह डिफ़ॉल्ट रूप से बंद होता है. दो अक्षरों वाला कोड, जिससे उपयोगकर्ता के देश या इलाके का पता चलता है. यह UN M49 वाला देश का कोड भी हो सकता है.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.commonEventObject.userLocale फ़ील्ड में देखें.

eventObject.userLocale string
अब इसका इस्तेमाल नहीं किया जा सकता और यह डिफ़ॉल्ट रूप से बंद होता है. दो अक्षरों वाला आईएसओ 639 कोड, जिससे उपयोगकर्ता की भाषा का पता चलता है. ज़्यादा जानकारी के लिए, उपयोगकर्ता की भाषा और समय क्षेत्र की जानकारी ऐक्सेस करना लेख पढ़ें.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.commonEventObject.userLocale फ़ील्ड में देखें.

eventObject.userTimezone.id string
अब इसका इस्तेमाल नहीं किया जा सकता और यह डिफ़ॉल्ट रूप से बंद होता है. उपयोगकर्ता के टाइमज़ोन का टाइमज़ोन आइडेंटिफ़ायर. उदाहरण के लिए: America/New_York, Europe/Vienna, और Asia/Seoul. ज़्यादा जानकारी के लिए, उपयोगकर्ता की स्थान-भाषा और समय क्षेत्र की जानकारी ऐक्सेस करना लेख पढ़ें.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.commonEventObject.timeZone.id फ़ील्ड में देखें.

eventObject.userTimezone.offset string
अब इसका इस्तेमाल नहीं किया जा सकता और यह डिफ़ॉल्ट रूप से बंद होता है. उपयोगकर्ता के टाइमज़ोन का कोऑर्डिनेटेड यूनिवर्सल टाइम (यूटीसी) से टाइम ऑफ़सेट, जिसे मिलीसेकंड में मापा जाता है. ज़्यादा जानकारी के लिए, उपयोगकर्ता की स्थान-भाषा और समय क्षेत्र की जानकारी ऐक्सेस करना लेख पढ़ें.

Google Workspace ऐड-ऑन के लिए, यह जानकारी eventObject.commonEventObject.timeZone.offset फ़ील्ड में देखें.

सामान्य इवेंट ऑब्जेक्ट

कॉमन इवेंट ऑब्जेक्ट, पूरे इवेंट ऑब्जेक्ट का वह हिस्सा होता है जिसमें ऐड-ऑन के लिए सामान्य जानकारी होती है. यह जानकारी, होस्ट से जुड़ी नहीं होती. यह जानकारी, उपयोगकर्ता के क्लाइंट से ऐड-ऑन को मिलती है. इस जानकारी में, उपयोगकर्ता के स्थान-भाषा, होस्ट ऐप्लिकेशन, और प्लैटफ़ॉर्म जैसी जानकारी शामिल होती है.

होम पेज और कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाले ऐड-ऑन के अलावा, ऐड-ऑन इवेंट ऑब्जेक्ट बनाते हैं और उन्हें ऐक्शन कॉलबैक फ़ंक्शन को पास करते हैं. ऐसा तब होता है, जब उपयोगकर्ता विजेट से इंटरैक्ट करता है. आपके ऐड-ऑन का कॉलबैक फ़ंक्शन, सामान्य इवेंट ऑब्जेक्ट से क्वेरी कर सकता है. इससे यह पता चलता है कि उपयोगकर्ता के क्लाइंट में खुले हुए विजेट में क्या-क्या कॉन्टेंट है. उदाहरण के लिए, आपका ऐड-ऑन, eventObject.commentEventObject.formInputs ऑब्जेक्ट में मौजूद TextInput विजेट में उपयोगकर्ता के डाले गए टेक्स्ट का पता लगा सकता है.

सामान्य इवेंट ऑब्जेक्ट फ़ील्ड
commonEventObject.platform string
इससे पता चलता है कि इवेंट कहां से शुरू हुआ (`WEB`, `IOS` या `ANDROID`).
commonEventObject.formInputs object
दिखाए गए कार्ड में मौजूद विजेट की मौजूदा वैल्यू वाला मैप. मैप की कुंजियां, स्ट्रिंग आईडी होती हैं. ये हर विजेट के साथ असाइन की जाती हैं.

मैप वैल्यू ऑब्जेक्ट का स्ट्रक्चर, विजेट के टाइप पर निर्भर करता है:

  • सिंगल वैल्यू वाले विजेट (उदाहरण के लिए, टेक्स्ट बॉक्स): स्ट्रिंग की सूची (सिर्फ़ एक एलिमेंट).

    उदाहरण: अगर टेक्स्ट इनपुट विजेट का आईडी employeeName है, तो टेक्स्ट इनपुट की वैल्यू को इस तरह ऐक्सेस करें: e.commonEventObject.formInputs.employeeName.stringInputs.value[0]

  • एक से ज़्यादा वैल्यू वाले विजेट (उदाहरण के लिए, चेकबॉक्स ग्रुप): स्ट्रिंग की सूची.

    उदाहरण: एक से ज़्यादा वैल्यू वाले विजेट के लिए, जिसका आईडी participants है, वैल्यू के कलेक्शन को इस तरह ऐक्सेस करें: e.commonEventObject.formInputs.participants.stringInputs.value.

  • A date-time picker: a DateTimeInput object.

    उदाहरण: myDTPicker आईडी वाले पिकर के लिए, DateTimeInput ऑब्जेक्ट को ऐक्सेस करने के लिए, e.commonEventObject.formInputs.myDTPicker.dateTimeInput का इस्तेमाल करें.

  • A date-only picker: a DateInput object.

    उदाहरण: myDatePicker आईडी वाले पिकर के लिए, e.commonEventObject.formInputs.myDatePicker.dateInput का इस्तेमाल करके DateInput ऑब्जेक्ट को ऐक्सेस करें.

  • A time-only picker: a TimeInput object.

    उदाहरण: myTimePicker आईडी वाले पिकर के लिए, e.commonEventObject.formInputs.myTimePicker.timeInput का इस्तेमाल करके TimeInput ऑब्जेक्ट को ऐक्सेस करें.
commonEventObject.hostApp string
यह उस होस्ट ऐप्लिकेशन के बारे में बताता है जिसमें इवेंट ऑब्जेक्ट जनरेट होने पर ऐड-ऑन चालू होता है. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
actionParameters या Action.setParameters का इस्तेमाल करके, किसी कार्रवाई के लिए उपलब्ध कराए गए अतिरिक्त पैरामीटर.

डेवलपर के लिए झलक: Google Chat ऐप्लिकेशन के लिए, मल्टीसिलेक्ट मेन्यू में उपयोगकर्ताओं के टाइप किए गए शब्दों के आधार पर आइटम सुझाने के लिए, "autocomplete_widget_query" कुंजी (event.commonEventObject.parameters["autocomplete_widget_query"]) की वैल्यू का इस्तेमाल करें. इस वैल्यू का इस्तेमाल, डेटाबेस से क्वेरी करने और उपयोगकर्ताओं को टाइप करते समय चुनने लायक आइटम सुझाने के लिए किया जा सकता है. ज़्यादा जानकारी के लिए, Google Chat इस्तेमाल करने वाले लोगों की जानकारी इकट्ठा और प्रोसेस करना लेख पढ़ें.
commonEventObject.userLocale string
डिफ़ॉल्ट रूप से बंद होती है. उपयोगकर्ता की भाषा और देश/इलाके की पहचान करने वाला कोड. यह कोड, ISO 639 भाषा कोड-ISO 3166 देश/इलाके के कोड के फ़ॉर्मैट में होता है. उदाहरण के लिए, en-US.

इस फ़ील्ड को चालू करने के लिए, आपको अपने ऐड-ऑन के मेनिफ़ेस्ट में addOns.common.useLocaleFromApp को true पर सेट करना होगा. आपके ऐड-ऑन की स्कोप लिस्ट में https://www.googleapis.com/auth/script.locale भी शामिल होना चाहिए. ज़्यादा जानकारी के लिए, उपयोगकर्ता की स्थान-भाषा और समय क्षेत्र की जानकारी ऐक्सेस करना लेख पढ़ें.

commonEventObject.timeZone string
डिफ़ॉल्ट रूप से बंद होती है. टाइमज़ोन आईडी और ऑफ़सेट. इस फ़ील्ड को चालू करने के लिए, आपको अपने ऐड-ऑन के मेनिफ़ेस्ट में addOns.common.useLocaleFromApp को true पर सेट करना होगा. आपके ऐड-ऑन की स्कोप सूची में https://www.googleapis.com/auth/script.locale भी शामिल होना चाहिए. ज़्यादा जानकारी के लिए, उपयोगकर्ता की स्थान-भाषा और समय क्षेत्र की जानकारी ऐक्सेस करना लेख पढ़ें.
commonEventObject.timeZone.id string
उपयोगकर्ता के टाइमज़ोन का टाइमज़ोन आइडेंटिफ़ायर. उदाहरण के लिए: America/New_York, Europe/Vienna, और Asia/Seoul. इस फ़ील्ड को चालू करने के लिए, आपको अपने ऐड-ऑन के मेनिफ़ेस्ट में addOns.common.useLocaleFromApp को true पर सेट करना होगा. आपके ऐड-ऑन की स्कोप सूची में https://www.googleapis.com/auth/script.locale भी शामिल होना चाहिए. ज़्यादा जानकारी के लिए, उपयोगकर्ता की स्थान-भाषा और समय क्षेत्र की जानकारी ऐक्सेस करना लेख पढ़ें.
commonEventObject.timeZone.offset string
उपयोगकर्ता के टाइमज़ोन का कोऑर्डिनेटेड यूनिवर्सल टाइम (यूटीसी) से टाइम ऑफ़सेट, जिसे मिलीसेकंड में मापा जाता है. ज़्यादा जानकारी के लिए, उपयोगकर्ता की स्थान-भाषा और समय क्षेत्र की जानकारी ऐक्सेस करना लेख पढ़ें.

तारीख और समय चुनने वाले टूल की मदद से फ़ॉर्म में इनपुट देना

ऐक्शन कॉलबैक फ़ंक्शन, commonEventObject.formInputs फ़ील्ड में विजेट की मौजूदा वैल्यू पा सकते हैं. इसमें तारीख या समय चुनने वाले विजेट में, उपयोगकर्ता की चुनी गई तारीख या समय की वैल्यू शामिल होती हैं. जानकारी का स्ट्रक्चर इस बात पर निर्भर करता है कि विजेट को तारीख और समय चुनने वाले टूल, सिर्फ़ तारीख चुनने वाले टूल या सिर्फ़ समय चुनने वाले टूल के तौर पर कॉन्फ़िगर किया गया था. स्ट्रक्चर में मौजूद अंतर के बारे में यहां दी गई टेबल में बताया गया है:

DateTimeInput ऑब्जेक्ट
dateTimeInput.hasDate boolean
true अगर इनपुट की गई तारीख और समय में तारीख शामिल है; अगर false में सिर्फ़ समय शामिल है.
dateTimeInput.hasTime अगर इनपुट की तारीख और समय में समय शामिल है, तो boolean
true; अगर false में सिर्फ़ तारीख शामिल है.
dateTimeInput.msSinceEpoch string
उपयोगकर्ता ने जो समय चुना है वह मिलीसेकंड में इपॉक (1 जनवरी, 1970 को 00:00:00 यूटीसी) के बाद से.
DateInput ऑब्जेक्ट
dateInput.msSinceEpoch string
उपयोगकर्ता ने जो समय चुना है वह मिलीसेकंड में इपॉक (1 जनवरी, 1970 को 00:00:00 यूटीसी) के बाद से.
TimeInput ऑब्जेक्ट
timeInput.hours number
उपयोगकर्ता ने जो घंटे की संख्या चुनी है.
timeInput.minutes number
उपयोगकर्ता ने जो मिनट चुना है उसकी संख्या.

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

Chat इवेंट ऑब्जेक्ट, पूरे इवेंट ऑब्जेक्ट का वह हिस्सा होता है जिसमें Chat ऐप्लिकेशन के साथ उपयोगकर्ता के इंटरैक्शन की जानकारी होती है. यह सिर्फ़ उस इवेंट ऑब्जेक्ट में मौजूद होता है जिसमें ऐड-ऑन, Google Chat की सुविधाओं को बढ़ाता है.

Chat
chat.user object (User)
Chat ऐप्लिकेशन से इंटरैक्ट करने वाला Chat उपयोगकर्ता.
chat.space object (Space)
वह Chat स्पेस जहां उपयोगकर्ता ने Chat ऐप्लिकेशन के साथ इंटरैक्ट किया.
chat.eventTime

string (Timestamp format)

इंटरैक्शन होने का समय.

यूनियन फ़ील्ड payload. ऐप्लिकेशन होम ट्रिगर (जब कोई उपयोगकर्ता होम टैब खोलता है) के लिए, payload सेट नहीं होता है. साथ ही, chat में chat.user और chat.eventTime शामिल होता है.

payload इनमें से सिर्फ़ एक हो सकता है:
chat.messagePayload

object (MessagePayload)

यह पेलोड, Chat ऐप्लिकेशन को Message ट्रिगर से मिलता है.
chat.addedToSpacePayload

object (AddedToSpacePayload)

यह पेलोड, Chat ऐप्लिकेशन को स्पेस में जोड़ा गया ट्रिगर से मिलता है.
chat.removedFromSpacePayload

object (RemovedFromSpacePayload)

यह पेलोड, Chat ऐप्लिकेशन को स्पेस से हटाया गया ट्रिगर से मिलता है.
chat.buttonClickedPayload

object (ButtonClickedPayload)

यह वह पेलोड है जो Chat ऐप्लिकेशन को तब मिलता है, जब उपयोगकर्ता किसी मैसेज या कार्ड में मौजूद बटन पर क्लिक करते हैं. अगर कोई उपयोगकर्ता जानकारी सबमिट करने के लिए किसी बटन पर क्लिक करता है, तो commonEventObject.formInputs ऑब्जेक्ट में उपयोगकर्ता से इकट्ठा की गई वैल्यू शामिल होती हैं. ज़्यादा जानकारी के लिए, Google Chat इस्तेमाल करने वाले लोगों से जानकारी इकट्ठा करना लेख पढ़ें.
chat.widgetUpdatedPayload

object (WidgetUpdatedPayload)

यह वह पेलोड है जो Chat ऐप्लिकेशन को तब मिलता है, जब उपयोगकर्ता selectionInput विजेट के मल्टीसिलेक्ट मेन्यू में टेक्स्ट टाइप करते हैं. चैट ऐप्लिकेशन, इस इवेंट ऑब्जेक्ट का इस्तेमाल करके, डाइनैमिक डेटा सोर्स से सुझाए गए आइटम की जानकारी अपने-आप भर सकते हैं. उदाहरण के लिए, किसी बाहरी डेटा सोर्स से सहायता के मामलों की जानकारी भरने के लिए, कोई चैट ऐप्लिकेशन डेटा सोर्स से क्वेरी कर सकता है. यह क्वेरी, उपयोगकर्ता के मेन्यू में टाइप किए गए टेक्स्ट के आधार पर की जाती है. इसके बाद, यह ऐप्लिकेशन सहायता के मामलों से मिलती-जुलती जानकारी को चुनने लायक आइटम के तौर पर दिखाता है.

CommonEventObject.parameters['autocomplete_widget_query'] ऑब्जेक्ट में, वह स्ट्रिंग वैल्यू होती है जिसे उपयोगकर्ता मेन्यू में टाइप करता है.

chat.appCommandPayload

object (AppCommandPayload)

यह पेलोड, Chat ऐप्लिकेशन को तब मिलता है, जब कोई उपयोगकर्ता Chat ऐप्लिकेशन में किसी कमांड का इस्तेमाल करता है.

पेलोड

Chat ऐप्लिकेशन के साथ इंटरैक्शन के टाइप के आधार पर, इवेंट में Chat API के एक या उससे ज़्यादा संसाधनों वाला पेलोड होता है.

मैसेज पेलोड
MessagePayload
chat.messagePayload.message object (Message)
वह चैट मैसेज जिससे इवेंट ट्रिगर हुआ.
chat.messagePayload.space object (Space)
वह Chat स्पेस जिसमें उपयोगकर्ता ने मैसेज भेजा था. इस मैसेज की वजह से Chat ऐप्लिकेशन ट्रिगर हुआ.
chat.messagePayload.configCompleteRedirectUri string
यह वह यूआरएल है जिस पर Chat ऐप्लिकेशन को उपयोगकर्ता को रीडायरेक्ट करना चाहिए. ऐसा तब होता है, जब उपयोगकर्ता Google Chat से बाहर पुष्टि करने या कॉन्फ़िगरेशन की प्रोसेस पूरी कर लेता है. ज़्यादा जानकारी के लिए, Google Workspace ऐड-ऑन को तीसरे पक्ष की सेवा से कनेक्ट करना लेख पढ़ें.
स्पेस के पेलोड में जोड़ा गया
AddedToSpacePayload
chat.addedToSpacePayload.space object (Space)
वह Chat स्पेस जिसमें उपयोगकर्ता ने Chat ऐप्लिकेशन जोड़ा या इंस्टॉल किया है.

जब एडमिन, Chat ऐप्लिकेशन इंस्टॉल करते हैं, तब space.adminInstalled फ़ील्ड को true पर सेट किया जाता है.

chat.addedToSpacePayload.interactionAdd boolean
इससे यह पता चलता है कि किसी उपयोगकर्ता ने मैसेज का इस्तेमाल करके, Chat ऐप्लिकेशन को किसी स्पेस में जोड़ा है या नहीं. उदाहरण के लिए, Chat ऐप्लिकेशन को @mention करना या किसी कमांड का इस्तेमाल करना. अगर true, तो Chat एक और इवेंट ऑब्जेक्ट भेजता है. इसमें messagePayload होता है, जिसमें मैसेज के बारे में जानकारी होती है.
chat.addedToSpacePayload.configCompleteRedirectUri string
यह वह यूआरएल है जिस पर Chat ऐप्लिकेशन को उपयोगकर्ता को रीडायरेक्ट करना चाहिए. ऐसा तब होता है, जब उपयोगकर्ता Google Chat से बाहर पुष्टि करने या कॉन्फ़िगरेशन की प्रोसेस पूरी कर लेता है. ज़्यादा जानकारी के लिए, Google Workspace ऐड-ऑन को तीसरे पक्ष की सेवा से कनेक्ट करना लेख पढ़ें.
स्पेस के पेलोड से हटाया गया
RemovedFromSpacePayload
chat.removedFromSpacePayload.space object (Space)
वह Chat स्पेस जहां से उपयोगकर्ता ने Chat ऐप्लिकेशन को हटाया या अनइंस्टॉल किया है.

जब एडमिन, Chat ऐप्लिकेशन अनइंस्टॉल करते हैं, तब space.adminInstalled फ़ील्ड को false पर सेट कर दिया जाता है.

बटन पर क्लिक किए जाने का पेलोड
ButtonClickedPayload
chat.buttonClickedPayload.message object (Message)
वह चैट मैसेज जिसमें वह बटन मौजूद है जिस पर उपयोगकर्ता ने क्लिक किया.
chat.buttonClickedPayload.space object (Space)
वह Chat स्पेस जहां उपयोगकर्ता ने Chat ऐप्लिकेशन के मैसेज में मौजूद किसी बटन पर क्लिक किया.
chat.buttonClickedPayload.isDialogEvent boolean
इससे पता चलता है कि उपयोगकर्ता ने डायलॉग से इंटरैक्ट करने के लिए बटन पर क्लिक किया है या नहीं.
chat.buttonClickedPayload.dialogEventType enum (DialogEventType)
अगर isDialogEvent true है, तो डायलॉग में इंटरैक्शन किस तरह का है.

Enum DialogEventType.

dialogEventType की वैल्यू इनमें से सिर्फ़ एक हो सकती है:
TYPE_UNSPECIFIED डिफ़ॉल्ट मान. नहीं बताया गया है
REQUEST_DIALOG जब कोई उपयोगकर्ता किसी डायलॉग का अनुरोध करता है. उदाहरण के लिए, वे किसी निर्देश का इस्तेमाल करते हैं या मैसेज में मौजूद किसी बटन पर क्लिक करते हैं.
SUBMIT_DIALOG जब कोई उपयोगकर्ता, डायलॉग बॉक्स में मौजूद किसी इंटरैक्टिव एलिमेंट पर क्लिक करता है. उदाहरण के लिए, कोई उपयोगकर्ता किसी डायलॉग में जानकारी भरता है और जानकारी सबमिट करने के लिए किसी बटन पर क्लिक करता है.
विजेट का अपडेट किया गया पेलोड
WidgetUpdatedPayload
chat.widgetUpdatedPayload.space object (Space)
वह Chat स्पेस जहां इंटरैक्शन हुआ.
ऐप्लिकेशन कमांड पेलोड
AppCommandPayload
chat.appCommandPayload.appCommandMetadata object (AppCommandMetadata)
मेटाडेटा, जिसमें यह जानकारी होती है कि उपयोगकर्ता ने कौनसी कमांड इस्तेमाल की और उसे कैसे ट्रिगर किया.
chat.appCommandPayload.space object (Space)
वह Chat स्पेस जिसमें उपयोगकर्ता ने कमांड का इस्तेमाल किया.
chat.appCommandPayload.thread object (Thread)
अगर इंटरैक्शन किसी थ्रेड में हुआ है, तो Chat थ्रेड जहां उपयोगकर्ता ने कमांड का इस्तेमाल किया.
chat.appCommandPayload.message object (Message)
स्लैश कमांड के लिए, स्लैश कमांड वाला मैसेज.
chat.appCommandPayload.configCompleteRedirectUri string
अगर कमांड के लिए अनुमति या कॉन्फ़िगरेशन ज़रूरी है, तो Google Chat से बाहर प्रोसेस पूरी करने के बाद, उपयोगकर्ता को रीडायरेक्ट करने के लिए यूआरएल.
chat.appCommandPayload.isDialogEvent boolean
इससे यह तय होता है कि कमांड से डायलॉग बॉक्स खुलेगा या नहीं.
chat.appCommandPayload.dialogEventType enum (DialogEventType)
डायलॉग के साथ इंटरैक्शन किस तरह का है.

Enum DialogEventType.

dialogEventType की वैल्यू इनमें से सिर्फ़ एक हो सकती है:
TYPE_UNSPECIFIED डिफ़ॉल्ट मान. नहीं बताया गया है
REQUEST_DIALOG जब कोई उपयोगकर्ता किसी डायलॉग का अनुरोध करता है. उदाहरण के लिए, वे किसी निर्देश का इस्तेमाल करते हैं या मैसेज में मौजूद किसी बटन पर क्लिक करते हैं.
SUBMIT_DIALOG जब कोई उपयोगकर्ता, डायलॉग बॉक्स में मौजूद किसी इंटरैक्टिव एलिमेंट पर क्लिक करता है. उदाहरण के लिए, कोई उपयोगकर्ता किसी डायलॉग में जानकारी भरता है और जानकारी सबमिट करने के लिए किसी बटन पर क्लिक करता है.
ऐप्लिकेशन कमांड का मेटाडेटा
AppCommandMetadata
chat.appCommandPayload.appCommandMetadata.appCommandId

string (int64 format)

कमांड आईडी.
chat.appCommandPayload.appCommandMetadata.appCommandType enum (AppCommandType)
कमांड का टाइप.

Enum AppCommandType.

AppCommandType की वैल्यू इनमें से सिर्फ़ एक हो सकती है:
APP_COMMAND_TYPE_UNSPECIFIED डिफ़ॉल्ट मान. नहीं बताया गया है
SLASH_COMMAND कोई उपयोगकर्ता, स्लैश / से शुरू होने वाला मैसेज भेजकर कमांड का इस्तेमाल करता है.
QUICK_COMMAND उपयोगकर्ता, मैसेज के जवाब वाले बॉक्स में मौजूद Chat मेन्यू से कमांड चुनता है.

कैलेंडर इवेंट ऑब्जेक्ट

Calendar इवेंट ऑब्जेक्ट, इवेंट ऑब्जेक्ट का वह हिस्सा होता है जिसमें उपयोगकर्ता के कैलेंडर और कैलेंडर इवेंट के बारे में जानकारी होती है. यह सिर्फ़ इवेंट ऑब्जेक्ट में मौजूद होता है. ऐसा तब होता है, जब ऐड-ऑन Google Calendar का इस्तेमाल करता है.

यहां दी गई टेबल में, इवेंट ऑब्जेक्ट के calendarEventObject फ़ील्ड में मौजूद फ़ील्ड की सूची दी गई है. उपयोगकर्ता से मिला डेटा के तौर पर मार्क किए गए फ़ील्ड, इवेंट ऑब्जेक्ट में तब ही मौजूद होते हैं, जब Calendar इवेंट में डेटा मौजूद हो और ऐड-ऑन, addOns.calendar.currentEventAccess manifest फ़ील्ड को READ या READ_WRITE पर सेट करता हो.

इस ऑब्जेक्ट और इसके सबस्ट्रक्चर के कई फ़ील्ड के लिए, Calendar API इवेंट रिसोर्स के उसी नाम वाले फ़ील्ड से सीधे तौर पर मैपिंग की जाती है. अगर फ़ील्ड के ब्यौरे अलग-अलग हैं, तो यहां दी गई टेबल में दी गई जानकारी सही है.

कैलेंडर इवेंट ऑब्जेक्ट
calendar.attendees[] list of attendee objects
उपयोगकर्ता का जनरेट किया गया डेटा. कैलेंडर इवेंट में शामिल होने वाले लोगों की सूची.
calendar.calendarId string
कैलेंडर आईडी.
calendar.capabilities object
उपयोगकर्ता से मिला डेटा. यह ऑब्जेक्ट, इवेंट की जानकारी देखने या अपडेट करने के लिए ऐड-ऑन की सुविधाओं के बारे में बताता है.
calendar.capabilities.canAddAttendees boolean
उपयोगकर्ता से मिला डेटा. true अगर ऐड-ऑन, इवेंट में शामिल होने वाले लोगों की सूची में नए लोगों को जोड़ सकता है, तो true; false ऐसा न होने पर, false.
calendar.capabilities.canSeeAttendees boolean
उपयोगकर्ता से मिला डेटा. true अगर ऐड-ऑन, इवेंट में शामिल लोगों की सूची पढ़ सकता है; false अन्यथा.
calendar.capabilities.canSeeConferenceData boolean
उपयोगकर्ता से मिला डेटा. true अगर ऐड-ऑन, इवेंट के कॉन्फ़्रेंस डेटा को पढ़ सकता है, तो false अन्यथा.
calendar.capabilities.canSetConferenceData boolean
उपयोगकर्ता से मिला डेटा. true अगर ऐड-ऑन, इवेंट के कॉन्फ़्रेंस डेटा को अपडेट कर सकता है; false अन्यथा.
calendar.capabilities.canAddAttachments boolean
उपयोगकर्ता से मिला डेटा. true अगर ऐड-ऑन, इवेंट में नए अटैचमेंट जोड़ सकता है, तो; false ऐसा न होने पर.
calendar.conferenceData Conference data object
उपयोगकर्ता का जनरेट किया गया डेटा. यह ऑब्जेक्ट, इस इवेंट से जुड़े किसी भी कॉन्फ़्रेंस डेटा को दिखाता है. जैसे, Google Meet कॉन्फ़्रेंस की जानकारी.
calendar.id string
इवेंट आईडी.
calendar.organizer object
यह ऑब्जेक्ट, इवेंट के आयोजक को दिखाता है.
calendar.organizer.email string
इवेंट के आयोजक का ईमेल पता.
calendar.recurringEventId string
बार-बार होने वाले इवेंट का आईडी.

मेहमान

शामिल होने वाले व्यक्ति के ऑब्जेक्ट में, Google Calendar के इवेंट में शामिल होने वाले हर व्यक्ति के बारे में जानकारी होती है. यह जानकारी इवेंट ऑब्जेक्ट में मौजूद होती है. हालांकि, ऐसा सिर्फ़ तब होता है, जब Calendar इवेंट में डेटा मौजूद हो और ऐड-ऑन, addOns.calendar.currentEventAccess manifest फ़ील्ड को READ या READ_WRITE पर सेट करता हो.

मीटिंग में हिस्सा लेने वाले व्यक्ति का ऑब्जेक्ट
attendee.additionalGuests number
इसमें उन अतिरिक्त मेहमानों की संख्या होती है जिन्हें शामिल होने वाले व्यक्ति ने साथ लाने के लिए चुना है. डिफ़ॉल्ट रूप से, यह वैल्यू शून्य पर सेट होती है.
attendee.comment string
अगर किसी व्यक्ति ने जवाब दिया है, तो उसकी टिप्पणी.
attendee.displayName string
मीटिंग में शामिल होने वाले व्यक्ति का डिसप्ले नेम.
attendee.email string
मीटिंग में शामिल होने वाले व्यक्ति का ईमेल पता.
attendee.optional अगर इस व्यक्ति की उपस्थिति को 'ज़रूरी नहीं' के तौर पर मार्क किया गया है, तो boolean
true. अगर ऐसा नहीं है, तो false.
attendee.organizer boolean
true अगर इवेंट में शामिल होने वाला व्यक्ति, इस इवेंट का आयोजक है.
attendee.resource boolean
true अगर मीटिंग में शामिल होने वाला व्यक्ति किसी संसाधन, जैसे कि कमरा या कोई डिवाइस का प्रतिनिधित्व करता है; false अन्यथा.
attendee.responseStatus string
मीटिंग में शामिल होने वाले व्यक्ति के जवाब का स्टेटस. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • accepted: इस विकल्प का मतलब है कि शामिल होने वाले व्यक्ति ने इवेंट का न्योता स्वीकार कर लिया है.
  • declined: मेहमान ने इवेंट का न्योता अस्वीकार कर दिया है.
  • needsAction: मेहमान ने इवेंट के न्योते का जवाब नहीं दिया है.
  • tentative: मेहमान ने इवेंट में शामिल होने का न्योता स्वीकार कर लिया है.
attendee.self boolean
true अगर यह मेहमान उस कैलेंडर को दिखाता है जिसमें यह इवेंट दिखता है; false ऐसा न होने पर.

कॉन्फ़्रेंस का डेटा

कॉन्फ़्रेंस डेटा ऑब्जेक्ट में, Google Calendar के इवेंट से जुड़ी कॉन्फ़्रेंस की जानकारी होती है. ये Google के कॉन्फ़्रेंस समाधान हो सकते हैं, जैसे कि Google Meet या तीसरे पक्ष के कॉन्फ़्रेंस. यह जानकारी, इवेंट ऑब्जेक्ट में मौजूद होती है. हालांकि, ऐसा सिर्फ़ तब होता है, जब Calendar इवेंट में डेटा मौजूद हो और ऐड-ऑन, addOns.calendar.currentEventAccess manifest फ़ील्ड को READ या READ_WRITE पर सेट करता हो.

कॉन्फ़्रेंस का डेटा ऑब्जेक्ट
conferenceData.conferenceId string
कॉन्फ़्रेंस का आईडी. इस आईडी का इस्तेमाल, ऐप्लिकेशन को कॉन्फ़्रेंस को ट्रैक करने की अनुमति देने के लिए किया जाता है. आपको यह आईडी, उपयोगकर्ताओं को नहीं दिखाना चाहिए.
conferenceData.conferenceSolution object
कॉन्फ़्रेंस के समाधान को दिखाने वाला ऑब्जेक्ट, जैसे कि Hangouts या Google Meet.
conferenceData.conferenceSolution.iconUri string
उपयोगकर्ता को दिखने वाले आइकॉन का यूआरआई. यह आइकॉन, इस कॉन्फ़्रेंस समाधान को दिखाता है.
conferenceData.conferenceSolution.key object
यह वह कुंजी है जो इस इवेंट के लिए कॉन्फ़्रेंस समाधान की यूनीक पहचान करती है.
conferenceData.conferenceSolution.key.type string
कॉन्फ़्रेंस के समाधान का टाइप. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • eventHangout Hangouts for consumers के लिए (http://hangouts.google.com).
  • eventNamedHangout Google Workspace उपयोगकर्ताओं के लिए, Hangouts का क्लासिक वर्शन (http://hangouts.google.com).
  • hangoutsMeet for Google Meet (http://meet.google.com).
conferenceData.conferenceSolution.name string
यह प्रॉपर्टी, कॉन्फ़्रेंस सेवा का उपयोगकर्ता को दिखने वाला नाम (स्थानीय भाषा में नहीं) दिखाती है.
conferenceData.entryPoints[] list of entry point objects
कॉन्फ़्रेंस में शामिल होने के एंट्री पॉइंट की सूची. जैसे, यूआरएल या फ़ोन नंबर.
conferenceData.notes string
कॉन्फ़्रेंस के बारे में अतिरिक्त नोट (जैसे, डोमेन एडमिन के निर्देश या कानूनी सूचनाएं), जिन्हें उपयोगकर्ता को दिखाया जाना है. इसमें एचटीएमएल शामिल हो सकता है. ज़्यादा से ज़्यादा 2,048 वर्ण इस्तेमाल किए जा सकते हैं.
conferenceData.parameters object
यह एक ऐसा ऑब्जेक्ट है जिसमें ऐड-ऑन के इस्तेमाल के लिए, तय किए गए पैरामीटर डेटा का मैप होता है.
conferenceData.parameters.addOnParameters object
पैरामीटर स्ट्रिंग की कुंजियों और वैल्यू का मैप. इन कुंजियों और वैल्यू को ऐड-ऑन डेवलपर तय करता है, ताकि ऐड-ऑन के इस्तेमाल के लिए किसी कॉन्फ़्रेंस से जानकारी जोड़ी जा सके.

एंट्री पॉइंट

एंट्री पॉइंट ऑब्जेक्ट में, किसी कॉन्फ़्रेंस को ऐक्सेस करने के तरीके के बारे में जानकारी होती है. जैसे, फ़ोन या वीडियो के ज़रिए. यह जानकारी, इवेंट ऑब्जेक्ट में तब और सिर्फ़ तब मौजूद होती है, जब Calendar इवेंट में डेटा मौजूद हो और ऐड-ऑन, addOns.calendar.currentEventAccess manifest फ़ील्ड को READ या READ_WRITE पर सेट करता हो.

एंट्री पॉइंट ऑब्जेक्ट
entryPoint.accessCode string
कॉन्फ़्रेंस को ऐक्सेस करने के लिए इस्तेमाल किया गया ऐक्सेस कोड. इसमें ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं. कॉन्फ़्रेंस की सुविधा देने वाली कंपनियां, आम तौर पर कॉन्फ़्रेंस का ऐक्सेस देने के लिए {accessCode, meetingCode, passcode, password, pin} का सिर्फ़ एक सबसेट इस्तेमाल करती हैं. कॉन्फ़्रेंस की सेवा देने वाली कंपनी के इस्तेमाल किए गए फ़ील्ड से मैच करें और सिर्फ़ उन्हें दिखाएं.
entryPoint.entryPointFeatures list
एंट्री पॉइंट की सुविधाएं. फ़िलहाल, ये सुविधाएं सिर्फ़ phone एंट्री पॉइंट पर लागू होती हैं:
  • toll: एंट्री पॉइंट, टोल फ़ोन कॉल है.
  • toll_free: एंट्री पॉइंट, बिना किसी शुल्क के किया जाने वाला फ़ोन कॉल है.
entryPoint.entryPointType string
एंट्री पॉइंट का टाइप. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • more: कॉन्फ़्रेंस में शामिल होने के बारे में अतिरिक्त निर्देश. जैसे, अन्य फ़ोन नंबर. किसी कॉन्फ़्रेंस में सिर्फ़ एक more एंट्री पॉइंट हो सकता है. अगर कोई एंट्री पॉइंट मौजूद है, तो कम से कम एक अन्य तरह का एंट्री पॉइंट भी होना ज़रूरी है.
  • phone: किसी फ़ोन नंबर के ज़रिए कॉन्फ़्रेंस में शामिल हों. किसी कॉन्फ़्रेंस में शून्य या उससे ज़्यादा phone एंट्री पॉइंट हो सकते हैं. Google Calendar, फ़ॉर्मैट करने और वर्णमाला के क्रम में लगाने के बाद, सिर्फ़ पहले दो फ़ोन एंट्री पॉइंट दिखाता है.
  • sip: एसआईपी के ज़रिए कॉन्फ़्रेंस में शामिल हों. किसी कॉन्फ़्रेंस में ज़्यादा से ज़्यादा एक sip एंट्री पॉइंट हो सकता है.
  • video: एचटीटीपी के ज़रिए कॉन्फ़्रेंस में शामिल हों. किसी कॉन्फ़्रेंस में ज़्यादा से ज़्यादा एक video एंट्री पॉइंट हो सकता है.
entryPoint.label string
यह एंट्री पॉइंट यूआरआई के लिए, उपयोगकर्ता को दिखने वाला लेबल है. यह स्थानीय भाषा में नहीं होता.
entryPoint.meetingCode string
कॉन्फ़्रेंस को ऐक्सेस करने के लिए इस्तेमाल किया गया मीटिंग कोड. इसमें ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं. कॉन्फ़्रेंस की सुविधा देने वाली कंपनियां, आम तौर पर कॉन्फ़्रेंस का ऐक्सेस देने के लिए {accessCode, meetingCode, passcode, password, pin} का सिर्फ़ एक सबसेट इस्तेमाल करती हैं. कॉन्फ़्रेंस की सेवा देने वाली कंपनी के इस्तेमाल किए गए फ़ील्ड से मैच करें और सिर्फ़ उन्हें दिखाएं.
entryPoint.passcode string
कॉन्फ़्रेंस को ऐक्सेस करने के लिए इस्तेमाल किया गया पासकोड. इसमें ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं. कॉन्फ़्रेंस की सुविधा देने वाली कंपनियां, आम तौर पर कॉन्फ़्रेंस का ऐक्सेस देने के लिए {accessCode, meetingCode, passcode, password, pin} का सिर्फ़ एक सबसेट इस्तेमाल करती हैं. कॉन्फ़्रेंस की सेवा देने वाली कंपनी के इस्तेमाल किए गए फ़ील्ड से मैच करें और सिर्फ़ उन्हें दिखाएं.
entryPoint.password string
कॉन्फ़्रेंस को ऐक्सेस करने के लिए इस्तेमाल किया गया पासवर्ड. इसमें ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं. कॉन्फ़्रेंस की सुविधा देने वाली कंपनियां, आम तौर पर कॉन्फ़्रेंस का ऐक्सेस देने के लिए {accessCode, meetingCode, passcode, password, pin} का सिर्फ़ एक सबसेट इस्तेमाल करती हैं. कॉन्फ़्रेंस की सेवा देने वाली कंपनी के इस्तेमाल किए गए फ़ील्ड से मैच करें और सिर्फ़ उन्हें दिखाएं.
entryPoint.pin string
कॉन्फ़्रेंस को ऐक्सेस करने के लिए इस्तेमाल किया गया पिन. इसमें ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं. कॉन्फ़्रेंस की सुविधा देने वाली कंपनियां, आम तौर पर कॉन्फ़्रेंस का ऐक्सेस देने के लिए {accessCode, meetingCode, passcode, password, pin} का सिर्फ़ एक सबसेट इस्तेमाल करती हैं. कॉन्फ़्रेंस की सेवा देने वाली कंपनी के इस्तेमाल किए गए फ़ील्ड से मैच करें और सिर्फ़ उन्हें दिखाएं.
entryPoint.regionCode string
फ़ोन नंबर का क्षेत्र कोड. अगर यूआरआई में देश का कोड शामिल नहीं है, तो उपयोगकर्ताओं को इसकी ज़रूरत होती है. वैल्यू, CLDR की सार्वजनिक सूची में मौजूद क्षेत्र के कोड के आधार पर तय की जाती हैं.
entryPoint.uri string
एंट्री पॉइंट का यूआरआई. ज़्यादा से ज़्यादा 1,300 वर्ण इस्तेमाल किए जा सकते हैं. फ़ॉर्मैटिंग, एंट्री पॉइंट के टाइप पर निर्भर करती है:
  • more: http: या https: स्कीमा ज़रूरी है.
  • phone: tel: स्कीमा ज़रूरी है. यूआरआई में, डायल करने का पूरा क्रम शामिल होना चाहिए. उदाहरण के लिए, "tel:+12345678900,,,12345678;1234".
  • sip: sip: या sips: स्कीमा ज़रूरी है. उदाहरण के लिए, "sip:12345678@myprovider.com".
  • video: http: या https: स्कीमा ज़रूरी है.

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

Drive इवेंट ऑब्जेक्ट, पूरे इवेंट ऑब्जेक्ट का वह हिस्सा होता है जिसमें उपयोगकर्ता के Google Drive और उसके कॉन्टेंट के बारे में जानकारी होती है. यह सिर्फ़ इवेंट ऑब्जेक्ट में मौजूद होता है. ऐसा तब होता है, जब ऐड-ऑन Google Drive के साथ काम करता हो.

Drive इवेंट ऑब्जेक्ट
drive.activeCursorItem Drive item object
फ़िलहाल, Drive आइटम चालू है.
drive.selectedItems[] list of Drive item objects
Drive में चुनी गई फ़ाइलों या फ़ोल्डर की सूची.

Drive में मौजूद आइटम

Drive आइटम ऑब्जेक्ट में, Drive के किसी आइटम के बारे में जानकारी होती है. जैसे, फ़ाइलें या फ़ोल्डर.

Drive में मौजूद आइटम का ऑब्जेक्ट
item.addonHasFileScopePermission boolean
अगर true, तो ऐड-ऑन ने इस आइटम के लिए https://www.googleapis.com/auth/drive.file स्कोप की अनुमति का अनुरोध किया है और उसे यह अनुमति मिल गई है; ऐसा न होने पर, इस फ़ील्ड की वैल्यू false होती है.
item.id string
चुने गए आइटम का आईडी.
item.iconUrl string
चुने गए आइटम को दिखाने वाले आइकॉन का यूआरएल.
item.mimeType string
चुने गए आइटम का MIME टाइप.
item.title string
चुने गए आइटम का टाइटल.

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

Gmail इवेंट ऑब्जेक्ट, पूरे इवेंट ऑब्जेक्ट का वह हिस्सा होता है जिसमें उपयोगकर्ता के Gmail मैसेज के बारे में जानकारी होती है. यह सिर्फ़ इवेंट ऑब्जेक्ट में मौजूद होता है. ऐसा तब होता है, जब होस्ट ऐप्लिकेशन Gmail हो.

Gmail इवेंट ऑब्जेक्ट
gmail.accessToken string
Gmail के लिए ऐक्सेस टोकन. इस टोकन का इस्तेमाल GmailApp.setCurrentMessageAccessToken तरीके के साथ करें, ताकि आपके ऐड-ऑन को किसी उपयोगकर्ता के फ़िलहाल खुले हुए Gmail मैसेज का कुछ समय के लिए ऐक्सेस मिल सके. इसके अलावा, इससे आपके ऐड-ऑन को नए ड्राफ़्ट बनाने की अनुमति भी मिलती है.
gmail.bccRecipients[] list of strings
डिफ़ॉल्ट रूप से बंद होती है. "BCC:" फ़ील्ड में मौजूद ईमेल पतों की सूची. ये पते, ऐसे ड्राफ़्ट में शामिल होते हैं जिसे ऐड-ऑन लिख रहा है. इस फ़ील्ड को चालू करने के लिए, अपने मेनिफ़ेस्ट में addOns.gmail.composeTrigger.draftAccess फ़ील्ड को METADATA पर सेट करें.
gmail.ccRecipients[] list of strings
डिफ़ॉल्ट रूप से बंद होती है. "CC:" फ़ील्ड में मौजूद ईमेल पतों की सूची. ये पते, ऐड-ऑन के ज़रिए लिखे जा रहे ड्राफ़्ट में शामिल हैं. इस फ़ील्ड को चालू करने के लिए, अपने मेनिफ़ेस्ट में addOns.gmail.composeTrigger.draftAccess फ़ील्ड को METADATA पर सेट करें.
gmail.messageId string
फ़िलहाल खुले हुए Gmail मैसेज का आईडी.
gmail.threadId string
यह फ़िलहाल खुली हुई Gmail थ्रेड का आईडी है.
gmail.toRecipients[] list of strings
डिफ़ॉल्ट रूप से बंद होती है. "पाने वाला:" फ़ील्ड में मौजूद ईमेल पतों की सूची. ये ऐसे ईमेल पते हैं जिन्हें ऐड-ऑन, फ़िलहाल ड्राफ़्ट कर रहा है. इस फ़ील्ड को चालू करने के लिए, अपने मेनिफ़ेस्ट में addOns.gmail.composeTrigger.draftAccess फ़ील्ड को METADATA पर सेट करें.

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

Docs इवेंट ऑब्जेक्ट, पूरे इवेंट ऑब्जेक्ट का वह हिस्सा होता है जिसमें उपयोगकर्ता के दस्तावेज़ और उसके कॉन्टेंट के बारे में जानकारी होती है. यह सिर्फ़ इवेंट ऑब्जेक्ट में मौजूद होता है. ऐसा तब होता है, जब ऐड-ऑन Google Docs के साथ काम करता है.

Docs इवेंट ऑब्जेक्ट
docs.id string
यह सिर्फ़ तब मौजूद होता है, जब उपयोगकर्ता ने https://www.googleapis.com/auth/drive.file स्कोप को अनुमति दी हो.
Docs के यूज़र इंटरफ़ेस (यूआई) में खुले दस्तावेज़ का आईडी.
docs.title string
यह सिर्फ़ तब मौजूद होता है, जब उपयोगकर्ता ने https://www.googleapis.com/auth/drive.file स्कोप को अनुमति दी हो.
Docs के यूज़र इंटरफ़ेस (यूआई) में खुले दस्तावेज़ का टाइटल.
docs.addonHasFileScopePermission boolean
अगर true, तो ऐड-ऑन ने Docs के यूज़र इंटरफ़ेस (यूआई) में खुले दस्तावेज़ के लिए, स्कोप के ऐक्सेस का अनुरोध किया है और उसे https://www.googleapis.com/auth/drive.file मिला है. ऐसा न होने पर, यह फ़ील्ड false होता है.
docs.matchedUrl.url string
यह सिर्फ़ तब मौजूद होता है, जब ये शर्तें पूरी होती हैं:
  • https://www.googleapis.com/auth/workspace.linkpreview को उपयोगकर्ता ने अनुमति दी है.
  • यूआरएल, LinkPreviewTriggers ट्रिगर में दिए गए होस्ट पैटर्न से मेल खाता हो.

यह उस लिंक का यूआरएल है जिसकी झलक Google Docs में जनरेट होती है. इस फ़ील्ड का इस्तेमाल करने के लिए, आपको अपने ऐड-ऑन के मेनिफ़ेस्ट में LinkPreviewTriggers को कॉन्फ़िगर करना होगा. ज़्यादा जानकारी के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

जब कोई उपयोगकर्ता लिंक की झलक देखता है, तब पेलोड का उदाहरण https://www.example.com/12345: 

"docs" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}

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

Sheets इवेंट ऑब्जेक्ट, पूरे इवेंट ऑब्जेक्ट का वह हिस्सा होता है जिसमें उपयोगकर्ता के दस्तावेज़ और उसके कॉन्टेंट के बारे में जानकारी होती है. यह सिर्फ़ इवेंट ऑब्जेक्ट में मौजूद होता है. ऐसा तब होता है, जब ऐड-ऑन Google Sheets को बढ़ाता है.

Sheets इवेंट ऑब्जेक्ट
sheets.id string
यह सिर्फ़ तब मौजूद होता है, जब उपयोगकर्ता ने https://www.googleapis.com/auth/drive.file स्कोप को अनुमति दी हो. Sheets के यूज़र इंटरफ़ेस (यूआई) में खुली हुई स्प्रेडशीट का आईडी.
sheets.title string
यह सिर्फ़ तब मौजूद होता है, जब उपयोगकर्ता ने https://www.googleapis.com/auth/drive.file स्कोप को अनुमति दी हो. Sheets के यूज़र इंटरफ़ेस (यूआई) में खुली हुई स्प्रेडशीट का टाइटल.
sheets.addonHasFileScopePermission boolean
अगर true, तो इसका मतलब है कि ऐड-ऑन ने Sheets के यूज़र इंटरफ़ेस (यूआई) में खुली हुई स्प्रेडशीट के लिए, https://www.googleapis.com/auth/drive.file स्कोप के लिए अनुमति का अनुरोध किया है और उसे यह अनुमति मिल गई है. अगर ऐसा नहीं है, तो इस फ़ील्ड की वैल्यू false होती है.
sheets.matchedUrl.url string
यह सिर्फ़ तब मौजूद होता है, जब ये शर्तें पूरी होती हैं:
  • https://www.googleapis.com/auth/workspace.linkpreview को उपयोगकर्ता ने अनुमति दी है.
  • यूआरएल, LinkPreviewTriggers ट्रिगर में दिए गए होस्ट पैटर्न से मेल खाता हो.

यह उस लिंक का यूआरएल होता है जिसकी झलक Google Sheets में दिखती है. इस फ़ील्ड का इस्तेमाल करने के लिए, अपने ऐड-ऑन के मेनिफ़ेस्ट में LinkPreviewTriggers को कॉन्फ़िगर करें. ज़्यादा जानकारी के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

जब कोई उपयोगकर्ता लिंक की झलक देखता है, तब पेलोड का उदाहरण https://www.example.com/12345:

"sheets" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}

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

Slides इवेंट ऑब्जेक्ट, पूरे इवेंट ऑब्जेक्ट का वह हिस्सा होता है जिसमें उपयोगकर्ता के दस्तावेज़ और उसके कॉन्टेंट के बारे में जानकारी होती है. यह सिर्फ़ इवेंट ऑब्जेक्ट में मौजूद होता है. ऐसा तब होता है, जब ऐड-ऑन Google Slides के साथ काम करता हो.

Slides इवेंट ऑब्जेक्ट
slides.id string
यह सिर्फ़ तब मौजूद होता है, जब उपयोगकर्ता ने https://www.googleapis.com/auth/drive.file स्कोप को अनुमति दी हो. Slides के यूज़र इंटरफ़ेस (यूआई) में खुले हुए प्रज़ेंटेशन का आईडी.
slides.title string
यह सिर्फ़ तब मौजूद होता है, जब उपयोगकर्ता ने https://www.googleapis.com/auth/drive.file स्कोप को अनुमति दी हो. Slides के यूज़र इंटरफ़ेस (यूआई) में खुले हुए प्रज़ेंटेशन का टाइटल.
slides.addonHasFileScopePermission boolean
अगर true है, तो ऐड-ऑन ने Slides के यूज़र इंटरफ़ेस (यूआई) में खुले प्रज़ेंटेशन के लिए, https://www.googleapis.com/auth/drive.file स्कोप के लिए अनुमति का अनुरोध किया है और उसे अनुमति मिल गई है; अगर ऐसा नहीं है, तो यह फ़ील्ड false है.
slides.matchedUrl.url string
यह सिर्फ़ तब मौजूद होता है, जब ये शर्तें पूरी होती हैं:
  • https://www.googleapis.com/auth/workspace.linkpreview को उपयोगकर्ता ने अनुमति दी है.
  • यूआरएल, LinkPreviewTriggers ट्रिगर में दिए गए होस्ट पैटर्न से मेल खाता हो.

यह उस लिंक का यूआरएल है जिसकी झलक Google Slides में जनरेट होती है. इस फ़ील्ड का इस्तेमाल करने के लिए, अपने ऐड-ऑन के मेनिफ़ेस्ट में LinkPreviewTriggers को कॉन्फ़िगर करें. ज़्यादा जानकारी के लिए, स्मार्ट चिप की मदद से लिंक की झलक देखना लेख पढ़ें.

जब कोई उपयोगकर्ता लिंक की झलक देखता है, तब पेलोड का उदाहरण https://www.example.com/12345:

"slides" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}