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

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

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

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

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