التذكيرات والإشعارات

توفّر Google Calendar API إمكانية استخدام التذكيرات والإشعارات.

  • التذكيرات هي تنبيهات يتم تفعيلها في وقت محدّد قبل بدء الحدث.
  • تتيح الإشعارات للمستخدمين الاطّلاع على التغييرات التي يتم إجراؤها على الأحداث في تقويمهم.

لا تخلط بين الإشعارات والإشعارات الفورية التي تُعلم خادمًا آخر بالتغييرات التي يتم إجراؤها على تقويم بدلاً من إرسالها إلى مستخدم.

لمزيد من التفاصيل حول الإشعارات في "تقويم Google"، يمكنك الاطّلاع على مقالة تعديل إشعارات "تقويم Google".

التذكيرات

يتألف التذكير من:

  • الوقت الذي سيظهر فيه التذكير، ويتم التعبير عنه بالدقائق قبل وقت بدء الحدث.
  • طريقة التسليم التي سيتم استخدامها (راجِع آليات التسليم).

يمكن تحديد التذكيرات للتقاويم بأكملها وللأحداث الفردية. يمكن للمستخدمين ضبط تذكيرات تلقائية لكل تقويم من تقاويمهم، وتنطبق هذه التذكيرات التلقائية على جميع الأحداث في هذا التقويم. ومع ذلك، يمكن للمستخدمين أيضًا إلغاء هذه التذكيرات التلقائية للأحداث الفردية، واستبدالها بمجموعة مختلفة من التذكيرات.

التذكيرات التلقائية

التذكيرات هي معلومات خاصة بمستخدم تم التحقّق من هويته، ولا تتم مشاركتها بين عدة مستخدمين. نتيجةً لذلك:

  • يتم التعامل مع التذكيرات التلقائية من خلال مجموعة CalendarList التي تحتوي على بيانات وصفية خاصة بالمستخدمين.
  • لا يمكن الوصول إليها من خلال مجموعة Calendars التي تحتوي على بيانات وصفية عامة تتم مشاركتها بين جميع المستخدمين.

يتم أيضًا عرض التذكيرات التلقائية عند إجراء طلب بحث عن قائمة الأحداث.

إلغاء التذكيرات التلقائية

لإلغاء التذكيرات التلقائية عند إنشاء حدث أو تعديله، اضبط reminders.useDefault على false واملأ reminders.overrides بمجموعة التذكيرات الجديدة. لا يمكن ضبط عمليات الإلغاء إلا عندما تكون قيمة useDefault هي false، كما هو موضّح في المثال التالي:

"reminders": {
  "useDefault": false,
  "overrides": [
    {
      "method": "reminderMethod",
      "minutes": "reminderMinutes"
    }
  ]
}

للرجوع إلى المجموعة التلقائية من التذكيرات، نفِّذ عملية تعديل واضبط reminders.useDefault على true مرة أخرى.

الإشعارات

يتيح "تقويم Google" أنواع الإشعارات التالية:

  • إنشاء حدث: تتم إضافة حدث جديد إلى أحد تقاويم المستخدم.
  • تغيير الحدث: عدَّل المنظِّم حدثًا تمت دعوة المستخدم إليه.
  • إلغاء الحدث: تم إلغاء حدث تمت دعوة المستخدم إليه.
  • ردّ المشارِك: غيَّر أحد المشارِكين حالة الردّ على حدث أنشأه المستخدم.
  • جدول الأعمال: قائمة بجميع الأحداث في تقويم المستخدم، يتم إرسالها في بداية اليوم.

يمكن للمستخدم تحديد الإشعارات التي يريد تفعيلها لكل تقويم وطريقة التسليم لكل نوع من أنواع الإشعارات. لا تتم مشاركة هذه الإعدادات مع مستخدمين آخرين. على غرار التذكيرات التلقائية، يمكن الوصول إليها من خلال مجموعة CalendarList.

لإرسال إشعارات بالبريد الإلكتروني إلى الضيوف بشأن الأحداث التي تم إدراجها أو تعديلها باستخدام واجهة برمجة التطبيقات، اتّصِل بالـ insert أو update واضبط المَعلمة sendUpdates على "all" أو "externalOnly".

آليات التسليم

طرق التسليم التي يقدّمها "تقويم Google" هي:

  • النافذة المنبثقة : تتوفّر هذه الطريقة على منصات الأجهزة الجوّالة وعلى برامج الويب.
  • البريد الإلكتروني الذي يرسله الخادم:

يوضّح الجدول التالي الطرق المتاحة لكل نوع من أنواع التذكيرات أو الإشعارات:

النافذة المنبثقة البريد الإلكتروني
التذكيرات التذكيرات التلقائية ✓ ✓
إلغاء التذكيرات ✓ ✓
الإشعارات إنشاء حدث ❌ ✓
تغيير الحدث ❌ ✓
إلغاء الحدث ❌ ✓
ردّ المشارِك ❌ ✓
جدول الأعمال ❌ ✓