रिमाइंडर और सूचनाएं

Calendar API, रिमाइंडर और सूचनाओं के लिए सहायता देता है.

  • रिमाइंडर ऐसे अलार्म होते हैं जो किसी इवेंट के शुरू होने से पहले, तय समय पर ट्रिगर होते हैं.
  • सूचनाओं से, उपयोगकर्ता अपने कैलेंडर में हुए इवेंट में हुए बदलावों के बारे में जान सकते हैं.

बाद वाले आइटम को पुश नोटिफ़िकेशन नहीं समझना चाहिए. यह उपयोगकर्ता को भेजे जाने के बजाय, दूसरे सर्वर को कैलेंडर में हुए बदलावों की सूचना देती है.

Google Calendar की सूचनाओं के बारे में ज़्यादा जानने के लिए, Google Calendar की सूचनाओं के लिए सेटिंग बदलना पर जाएं.

Reminders

रिमाइंडर में ये चीज़ें शामिल होती हैं:

  • रिमाइंडर कब दिखाना है, इसे इवेंट के शुरू होने के समय से मिनट पहले के तौर पर दिखाया जाता है
  • डिलीवरी के लिए इस्तेमाल किया जाने वाला तरीका (डिलीवरी के तरीके देखें)

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

डिफ़ॉल्ट रिमाइंडर

रिमाइंडर ऐसी निजी जानकारी होती है जिसे किसी ऐसे उपयोगकर्ता के लिए खास तौर पर निजी जानकारी के तौर पर इस्तेमाल किया जाता है जिसकी पुष्टि हो चुकी है. इन्हें अलग-अलग लोगों के साथ शेयर नहीं किया जाता. इससे ये फ़ायदे होते हैं:

  • डिफ़ॉल्ट रिमाइंडर में, 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 कलेक्शन से ऐक्सेस किया जा सकता है.

एपीआई की मदद से डाले गए या अपडेट किए गए इवेंट के बारे में, इवेंट में शामिल होने वाले लोगों को ईमेल सूचनाएं भेजने के लिए, इंसर्शन/अपडेट करने के अनुरोध में sendNotifications पैरामीटर को 'सही' पर सेट करें.

डिलीवरी के तरीके

Google Calendar, डिलीवरी के ये तरीके उपलब्ध कराता है:

  • पॉप-अप. इनका इस्तेमाल मोबाइल प्लैटफ़ॉर्म और वेब क्लाइंट पर किया जा सकता है.
  • सर्वर से भेजा गया ईमेल.

यहां दी गई टेबल में, हर तरह के रिमाइंडर या सूचना के लिए इस्तेमाल किए जा सकने वाले तरीके दिखाए गए हैं:

पॉप-अप ईमेल
रिमाइंडर डिफ़ॉल्ट रिमाइंडर ✓ ✓
रिमाइंडर बदलें ✓ ✓
सूचनाएं इवेंट बनाना ❌ ✓
इवेंट में बदलाव ❌ ✓
इवेंट रद्द करें ❌ ✓
मीटिंग में शामिल होने वाले मेहमान का जवाब ❌ ✓
एजेंडा ❌ ✓