Deletes an event. Try it now or see an example.
Request
HTTP request
DELETE https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
Parameters
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
calendarId |
string |
Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary " keyword.
|
eventId |
string |
Event identifier. |
Optional query parameters | ||
sendNotifications |
boolean |
Deprecated. Please use sendUpdates instead. Whether to send notifications about the deletion of the event. Note that some emails might still be sent even if you set the value to false . The default is false .
|
sendUpdates |
string |
Guests who should receive notifications about the deletion of the event.
Acceptable values are:
|
Authorization
This request requires authorization with at least one of the following scopes:
Scope |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
For more information, see the authentication and authorization page.
Request body
Do not supply a request body with this method.
Response
If successful, this method returns an empty response body.
Examples
Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).
Java
Uses the Java client library.
import com.google.api.services.calendar.Calendar; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Delete an event service.events().delete('primary', "eventId").execute();
Python
Uses the Python client library.
service.events().delete(calendarId='primary', eventId='eventId').execute()
PHP
Uses the PHP client library.
$service->events->delete('primary', 'eventId');
Ruby
Uses the Ruby client library.
client.delete_event('primary', 'eventId')
Try it!
Use the APIs Explorer below to call this method on live data and see the response.