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

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

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

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

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

التذكيرات

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

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

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

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

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

  • يتم تعديل التذكيرات التلقائية من خلال مجموعة 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، تمامًا مثل التذكيرات التلقائية.

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

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

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

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

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

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