Events: delete

Löscht einen Termin. Probieren Sie es jetzt aus oder sehen Sie sich ein Beispiel an.

Anfrage

HTTP-Anfrage

DELETE https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

Parameter

Parametername Wert Beschreibung
Pfadparameter
calendarId string Kalender-ID. Rufen Sie zum Abrufen von Kalender-IDs die Methode calendarList.list auf. Wenn Sie auf den Hauptkalender des aktuell angemeldeten Nutzers zugreifen möchten, verwenden Sie die „primary“ Keyword.
eventId string Ereignis-ID.
Optionale Abfrageparameter
sendNotifications boolean Verworfen. Verwenden Sie stattdessen sendUpdates.

Gibt an, ob Benachrichtigungen zum Löschen des Termins gesendet werden sollen. Beachten Sie, dass einige E-Mails möglicherweise trotzdem gesendet werden, auch wenn Sie den Wert auf false setzen. Der Standardwert ist false.
sendUpdates string Gäste, die über das Löschen des Termins benachrichtigt werden sollen.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • „all“: Benachrichtigungen werden an alle Gäste gesendet.
  • „externalOnly“: Benachrichtigungen werden nur an Gäste gesendet, die Google Kalender nicht verwenden.
  • „none“: Es werden keine Benachrichtigungen gesendet. Für Aufgaben der Kalendermigration sollten Sie stattdessen die Methode Events.import verwenden.

Autorisierung

Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

Umfang
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Wenn der Vorgang erfolgreich ist, gibt diese Methode einen leeren Antworttext zurück.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

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

Verwendet die Python-Clientbibliothek.

service.events().delete(calendarId='primary', eventId='eventId').execute()

PHP

Verwendet die PHP-Clientbibliothek.

$service->events->delete('primary', 'eventId');

Ruby

Verwendet die Ruby-Clientbibliothek.

client.delete_event('primary', 'eventId')

Testen!

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.