تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توفّر Calendar API إمكانية استخدام التذكيرات والإشعارات.
التذكيرات هي منبّهات يتم تشغيلها في وقت محدّد قبل بدء حدث.
تتيح الإشعارات للمستخدمين معرفة التغييرات التي تطرأ على الأحداث في تقويمهم.
يجب عدم الخلط بين هذا العنصر والإشعارات الفورية التي يتم إرسالها إلى خادم آخر لإعلامه بالتغييرات التي تم إجراؤها على التقويم بدلاً من إرسالها إلى المستخدم.
وقت عرض التذكير، ويتم التعبير عنه بالدقائق قبل وقت بدء الحدث
طريقة التسليم التي سيتم استخدامها (راجِع آليات التسليم)
يمكن تحديد التذكيرات للتقاويم بأكملها ولأحداث فردية. يمكن للمستخدمين ضبط تذكيرات تلقائية لكل تقويم من تقاويمهم، وتنطبق هذه الإعدادات التلقائية على جميع الأحداث في هذا التقويم. ومع ذلك، يمكن للمستخدمين أيضًا تجاوز هذه الإعدادات التلقائية للأحداث الفردية واستبدالها بمجموعة مختلفة من التذكيرات.
التذكيرات التلقائية
التذكيرات هي معلومات خاصة بمستخدم تم إثبات هويته، وهي
لا تتم مشاركتها مع عدة مستخدمين. نتيجة لذلك:
يتم تعديل التذكيرات التلقائية من خلال مجموعة CalendarList التي تحتوي على بيانات وصفية خاصة بالمستخدمين حول التقويم.
لا يمكن الوصول إليها من خلال مجموعة التقاويم التي تحتوي على بيانات وصفية عامة تتم مشاركتها مع جميع المستخدمين.
يتم أيضًا عرض التذكيرات التلقائية عند إجراء طلب بحث في قائمة "الأحداث".
"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" هي:
نافذة منبثقة وهي متوافقة مع منصات الأجهزة الجوّالة وبرامج الويب.
الرسالة الإلكترونية التي أرسلها الخادم
يوضّح الجدول التالي الطرق المتاحة لكل نوع من أنواع التذكيرات أو الإشعارات:
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Reminders & notifications\n\nThe Calendar API provides support for reminders and notifications.\n\n- *Reminders* are alarms triggered at a specified time before an event starts.\n- *Notifications* allow users to find out about changes to events in their calendar.\n\nThe latter item should not be confused with [push\nnotifications](/workspace/calendar/v3/push) which, instead of being delivered\nto a user, notify another server of changes to a calendar.\n\u003e For more details about notifications in Google Calendar, go to\n\u003e [Modify Google Calendar notifications](https://support.google.com/calendar/answer/37242).\n\nReminders\n---------\n\nA reminder consists of:\n\n- When to show the reminder, expressed as minutes before the event start time\n- The delivery method to use (see [Delivery mechanisms](/workspace/calendar/concepts/reminders#delivery_mechanisms))\n\nReminders can be specified for whole calendars and for individual events. Users\ncan set *default reminders* for each of their calendars; these defaults apply to\nall events within that calendar. However, users can also override these\ndefaults for individual events, replacing them with a different set of\nreminders.\n\n### Default reminders\n\nReminders are private information, specific to an authenticated user; they're\n*not* shared across multiple users. As a result:\n\n- Default reminders are manipulated through the CalendarList collection, which contains user-specific calendar metadata\n- They're *not* accessible through the Calendars collection, which contains global metadata shared across all users.\n\nDefault reminders are also returned when doing an Events list query.\n\n### Overriding default reminders\n\nTo override the default reminders when you insert or modify an event, set\n[reminders.useDefault](/workspace/calendar/v3/reference/events#reminders.useDefault)\nto `false` and populate\n[reminders.overrides](/workspace/calendar/v3/reference/events#reminders.overrides)\nwith the new reminder set. \n\n \"reminders\": {\n \"useDefault\": false,\n # Overrides can be set if and only if useDefault is false.\n \"overrides\": [\n {\n \"method\": \"reminderMethod\",\n \"minutes\": \"reminderMinutes\"\n },\n # ...\n ]\n }\n\nTo revert to the default set of reminders, perform an update setting\n[reminders.useDefault](/workspace/calendar/v3/reference/events#reminders.useDefault)\nback to `true`.\n\nNotifications\n-------------\n\nCalendar supports the following notification types:\n\n- *Event creation*: a new event is added to one of the user's calendars.\n- *Event change*: the organizer modified an event the user was invited to.\n- *Event cancellation*: an event is canceled the user was invited to.\n- *Attendee response*: an attendee to an event created by the user changed their response status.\n- *Agenda*: a list of all the events in the user's calendar, sent at the start of the day.\n\nThe user can decide what notifications to enable per calendar and the delivery\nmethod for each notification type. These settings are not shared with other\nusers. Similar to default reminders, they're accessible through the\nCalendarList collection.\n\nTo send email notifications to attendees for events that were inserted or\nupdated with the API, call the\n[`insert`](/workspace/calendar/api/v3/reference/events/insert) or\n[`update`](/workspace/calendar/api/v3/reference/events/update) method and set\nthe `sendUpdates` parameter to `\"all\"` or `\"externalOnly\"`.\n| **Note:** For attendees with non-Google email addresses, these notification emails are the only way they can find out about the event; it's not added to their calendars automatically.\n\nDelivery mechanisms\n-------------------\n\nThe delivery methods offered by Google Calendar are:\n\n- *Pop-up*. These are supported on mobile platforms and on web clients.\n- *Email* sent by the server.\n\nThe following table shows the supported methods for each reminder or notification type:\n\n| | | Pop-up | Email |\n|-------------------|--------------------|--------|-------|\n| **Reminders** | Default reminders | ✓ | ✓ |\n| **Reminders** | Override reminders | ✓ | ✓ |\n| **Notifications** | Event creation | ❌ | ✓ |\n| **Notifications** | Event change | ❌ | ✓ |\n| **Notifications** | Event cancellation | ❌ | ✓ |\n| **Notifications** | Attendee response | ❌ | ✓ |\n| **Notifications** | Agenda | ❌ | ✓ |"]]
