"reminders": {
"useDefault": false,
# Overrides can be set if and only if useDefault is false.
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
},
# ...
]
}
[null,null,["最后更新时间 (UTC):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 | ❌ | ✓ |"]]