m365_move_email

Microsoft 365 · macOS · Windows

Wirkung: Schreiben. 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

Verwenden Sie es, wenn der Benutzer E-Mails seines Microsoft-365-/Outlook-Kontos auf dem Exchange-Server in einen anderen Ordner verschieben möchte, um sie abzulegen, zu archivieren oder zu organisieren. Nennen Sie die Nachrichten mit message_id (eine) oder message_ids (bis zu 50), aus m365_list_emails, m365_search_emails oder m365_read_email; oder eine ganze Konversation mit conversation_id (aus m365_list_emails oder m365_search_emails): Dann werden nur ihre Nachrichten in source_folder (Standard inbox) verschoben, nie ihre Kopien in Gesendete Elemente, Entwürfen oder anderen Ordnern, es sei denn, all_folders=true. destination ist eine Ordner-id, ein Name oder ein Pfad aus m365_list_email_folders, oder inbox, archive, deleteditems, junkemail. Zeigt zuerst eine Vorschau – setzen Sie confirm=true, um zu verschieben. Eine Nachricht gilt nur dann als verschoben, wenn ein zweites Lesen sie im Ziel zeigt und nicht mehr unter ihrer alten ID; eine verschobene Nachricht erhält eine neue ID (new_id). Erfordert die Microsoft-365-Berechtigung Mail.ReadWrite: Ein Konto, das verbunden wurde, bevor sie angefragt wurde, antwortet consent_required, bis es erneut verbunden wird. Für E-Mails in der Mail-App des Macs verwenden Sie move_email.

Erforderliche Eingaben

destination

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.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

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"
    },
    "all_folders": {
      "description": "With conversation_id: true moves its messages from every folder, Sent Items and Drafts included (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Set to true to move (default: shows a preview only).",
      "type": "boolean"
    },
    "conversation_id": {
      "description": "Move the messages of this conversation that are in source_folder.",
      "type": "string"
    },
    "destination": {
      "description": "The folder to move them to: an id, name or path from m365_list_email_folders, or inbox, archive, deleteditems, junkemail.",
      "type": "string"
    },
    "message_id": {
      "description": "The ID of one message to move.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 50 messages to move.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source_folder": {
      "description": "With conversation_id: the folder its messages are moved from (default inbox). An id, name or path.",
      "type": "string"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für m365_move_email. 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,
  "destination": "archive",
  "message_id": "demo-message-001"
}

Windows