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

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

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

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

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

Reminder

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

  • وقت عرض التذكير، مُعبَّرًا عنه بالدقائق قبل وقت بدء الحدث
  • طريقة التسليم المُستخدَمة (راجِع آليات التسليم)

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

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

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

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

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

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

لإلغاء التذكيرات التلقائية عند إدراج حدث أو تعديله، اضبط 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.

الإشعارات

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

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

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

لإرسال إشعارات عبر البريد الإلكتروني إلى الضيوف بشأن الأحداث التي تم إدراجها أو تعديلها من خلال واجهة برمجة التطبيقات، اضبط المَعلمة sendNotifications في طلب إدراج/تعديل على true.

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

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

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

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

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