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

تتيح واجهة برمجة تطبيقات التقويم إمكانية استخدام التذكيرات والإشعارات.

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

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

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

Reminders

يتكوّن التذكير مما يلي:

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

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

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

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

  • يتم التلاعب بالتذكيرات التلقائية من خلال مجموعة 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 في طلب الإدراج/التحديث على "صحيح".

آليات العرض

تتوفر طرق العرض التي يوفرها "تقويم Google" ما يلي:

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

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

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