Zum Inhalt springen
Alle Werkzeuge

m365_delete_event

Microsoft 365 · macOS · Windows

Wirkung: Löschen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Löscht ein Ereignis anhand seiner ID (aus m365_list_events) aus dem verbundenen Microsoft 365-/Outlook-Kalender. Wenn der Benutzer die Besprechung organisiert und sie Teilnehmer hat, sendet Microsoft 365 ihnen eine Absage. Bei einem wiederkehrenden Ereignis ist die ID aus m365_list_events die gesamte Serie: Das Löschen entfernt jedes Vorkommen. Erfordert confirm=true; ohne dies wird nichts gelöscht und die Antwort zeigt eine Vorschau des Ereignisses: Betreff, Datum, Teilnehmer und ob die ID eine ganze wiederkehrende Serie ist. Sagen Sie dem Benutzer vor der Bestätigung, um welches Ereignis es sich handelt – die ID allein verrät es nicht. Für die Kalender-App des Mac verwenden Sie stattdessen delete_calendar_event.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — macOS
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "confirm": {
      "description": "Set to true to confirm deletion (required)",
      "type": "boolean"
    },
    "id": {
      "description": "Event ID from m365_list_events",
      "type": "string"
    }
  },
  "required": [
    "id",
    "confirm"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für m365_delete_event. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false,
  "id": "demo-item-001"
}

Windows

Zweck

Löscht ein Ereignis anhand seiner ID aus dem Kalender des verbundenen Microsoft 365-Kontos: die Zeile `ID:`, die m365_list_events oder m365_create_event zurückgibt. Ohne confirm=true wird nichts gelöscht und die Antwort zeigt eine Vorschau des Ereignisses: Betreff, Datum, Teilnehmer und ob die ID eine ganze wiederkehrende Serie (jedes Vorkommen wird entfernt) oder ein einzelnes Vorkommen ist; sagen Sie dem Benutzer vor der Bestätigung, um welches Ereignis es sich handelt. Mit confirm=true wird das Ereignis in Microsoft 365 über Microsoft Graph gelöscht; ist der Benutzer der Organisator einer Besprechung, sendet Microsoft 365 den Teilnehmern eine Absage. Dieser Server hat kein Tool, um ein gelöschtes Ereignis wiederherzustellen. Eine ID, die nicht mehr existiert, liefert 'item not found'.

Erforderliche Eingaben

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "confirm": {
      "description": "Set to true to confirm deletion (required)",
      "type": "boolean"
    },
    "id": {
      "description": "Event ID from m365_list_events",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für m365_delete_event. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false,
  "id": "demo-item-001"
}