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

تتيح واجهة برمجة التطبيقات 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.

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

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

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

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

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