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

इस पेज पर, 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 आईडी वाले पिकर के लिए, e.commonEventObject.formInputs.myDTPicker.dateTimeInput का इस्तेमाल करके 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
उपयोगकर्ता ने जो समय चुना है वह epoch (1 जनवरी, 1970 को 00:00:00 यूटीसी) के बाद से मिलीसेकंड में दिखता है.
DateInput ऑब्जेक्ट
dateInput.msSinceEpoch string
उपयोगकर्ता ने जो समय चुना है वह epoch (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.messagePayload

object (MessagePayload)

Chat ऐप्लिकेशन को मैसेज ट्रिगर से मिलने वाला पेलोड.
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 मेन्यू से कमांड चुनता है.

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

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