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

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

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

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

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

التذكيرات

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

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

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

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

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

  • ويتم التعامل مع التذكيرات التلقائية من خلال مجموعة 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":

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

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

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