Calendar API, सूचनाओं और रिमाइंडर की सुविधा के साथ काम करता है.
- रिमाइंडर, इवेंट शुरू होने से पहले किसी तय समय पर ट्रिगर होने वाले अलार्म होते हैं.
- सूचनाओं की मदद से, लोग अपने कैलेंडर में मौजूद इवेंट में हुए बदलावों के बारे में जान सकते हैं.
दूसरे आइटम को पुश नोटिफ़िकेशन के साथ भ्रमित नहीं किया जाना चाहिए. पुश नोटिफ़िकेशन, किसी उपयोगकर्ता को डिलीवर करने के बजाय, किसी दूसरे सर्वर को कैलेंडर में हुए बदलावों के बारे में सूचना देते हैं.
Google Calendar में सूचनाओं के बारे में ज़्यादा जानने के लिए, Google Calendar की सूचनाओं की सेटिंग बदलना पर जाएं.
रिमाइंडर
रिमाइंडर में ये चीज़ें शामिल होती हैं:
- रिमाइंडर कब दिखाना है. इसे इवेंट शुरू होने के समय से पहले के मिनटों के तौर पर दिखाया जाता है
- डिलीवरी का इस्तेमाल किया जाने वाला तरीका (डिलीवरी के तरीके देखें)
रिमाइंडर, पूरे कैलेंडर और अलग-अलग इवेंट के लिए सेट किए जा सकते हैं. उपयोगकर्ता अपने हर कैलेंडर के लिए, डिफ़ॉल्ट रिमाइंडर सेट कर सकते हैं. ये डिफ़ॉल्ट रिमाइंडर, उस कैलेंडर में मौजूद सभी इवेंट पर लागू होते हैं. हालांकि, उपयोगकर्ता अलग-अलग इवेंट के लिए इन डिफ़ॉल्ट सेटिंग को बदल सकते हैं. इसके लिए, उन्हें रिमाइंडर का कोई दूसरा सेट इस्तेमाल करना होगा.
डिफ़ॉल्ट रिमाइंडर
रिमाइंडर निजी जानकारी होती है. यह सिर्फ़ पुष्टि किए गए उपयोगकर्ता के लिए होती है. इसे एक से ज़्यादा उपयोगकर्ताओं के साथ शेयर नहीं किया जाता. इससे ये फ़ायदे होते हैं:
- डिफ़ॉल्ट रिमाइंडर को CalendarList कलेक्शन के ज़रिए मैनेज किया जाता है. इसमें उपयोगकर्ता के कैलेंडर का मेटाडेटा होता है
- इन्हें Calendars कलेक्शन से ऐक्सेस नहीं किया जा सकता. इस कलेक्शन में, ग्लोबल मेटाडेटा होता है, जिसे सभी उपयोगकर्ताओं के साथ शेयर किया जाता है.
इवेंट की सूची के लिए क्वेरी करने पर, डिफ़ॉल्ट रिमाइंडर भी दिखते हैं.
रिमाइंडर के लिए डिफ़ॉल्ट सेटिंग बदलना
किसी इवेंट को शामिल करते या उसमें बदलाव करते समय, डिफ़ॉल्ट रिमाइंडर को बदलने के लिए, reminders.useDefault को false
पर सेट करें. इसके बाद, reminders.overrides में नया रिमाइंडर सेट करें.
"reminders": {
"useDefault": false,
# Overrides can be set if and only if useDefault is false.
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
},
# ...
]
}
रिमाइंडर के डिफ़ॉल्ट सेट पर वापस जाने के लिए, reminders.useDefault सेटिंग को अपडेट करके true
पर सेट करें.
सूचनाएं
Calendar में, इन सूचनाओं को पाने की सुविधा उपलब्ध है:
- इवेंट बनाना: जब उपयोगकर्ता के किसी कैलेंडर में नया इवेंट जोड़ा जाता है.
- इवेंट में बदलाव: आयोजक ने उस इवेंट में बदलाव किया है जिसमें उपयोगकर्ता को न्योता दिया गया था.
- इवेंट रद्द करना: जब उपयोगकर्ता को न्योता मिला हो और इवेंट रद्द कर दिया गया हो.
- शामिल होने वाले व्यक्ति का जवाब: इवेंट में शामिल होने वाले किसी व्यक्ति ने, इवेंट में शामिल होने के अपने स्टेटस में बदलाव किया है. यह इवेंट, उपयोगकर्ता ने बनाया था.
- एजेंडा: उपयोगकर्ता के कैलेंडर में मौजूद सभी इवेंट की सूची. इसे दिन की शुरुआत में भेजा जाता है.
उपयोगकर्ता यह तय कर सकता है कि उसे किस कैलेंडर के लिए कौनसी सूचनाएं चाहिए. साथ ही, वह यह भी तय कर सकता है कि उसे किस तरह की सूचनाएं किस तरीके से मिलें. ये सेटिंग, अन्य लोगों के साथ शेयर नहीं की जाती हैं. डिफ़ॉल्ट रिमाइंडर की तरह, इन्हें CalendarList कलेक्शन के ज़रिए ऐक्सेस किया जा सकता है.
एपीआई की मदद से जोड़े गए या अपडेट किए गए इवेंट के लिए, मेहमानों को ईमेल सूचनाएं भेजने के लिए, insert
या update
तरीके का इस्तेमाल करें. साथ ही, sendUpdates
पैरामीटर को "all"
या "externalOnly"
पर सेट करें.
डिलीवरी के तरीके
Google Calendar में डिलीवरी के ये तरीके उपलब्ध हैं:
- पॉप-अप. ये मोबाइल प्लैटफ़ॉर्म और वेब क्लाइंट पर काम करते हैं.
- सर्वर से भेजा गया ईमेल.
यहां दी गई टेबल में, हर तरह की सूचना या रिमाइंडर के लिए इस्तेमाल किए जा सकने वाले तरीकों के बारे में बताया गया है:
पॉप-अप | ईमेल | ||
---|---|---|---|
रिमाइंडर | डिफ़ॉल्ट रिमाइंडर | ✓ | ✓ |
रिमाइंडर को खारिज करना | ✓ | ✓ | |
सूचनाएं | इवेंट बनाना | ❌ | ✓ |
इवेंट में बदलाव | ❌ | ✓ | |
इवेंट रद्द करना | ❌ | ✓ | |
मेहमान का जवाब | ❌ | ✓ | |
एजेंडा | ❌ | ✓ |