m365_mark_email_read

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 als gelesen markieren möchte, oder mit unread=true als ungelesen: um festzuhalten, was bereits erledigt ist, oder um später zu einer Nachricht zurückzukehren. Nennen Sie die Nachrichten mit message_id (eine) oder message_ids (bis zu 20), aus m365_list_emails, m365_search_emails oder m365_read_email. Eine Nachricht gilt nur dann als markiert, wenn ein zweites Lesen den neuen Zustand zeigt. Es wird nichts gesendet, verschoben oder gelöscht, daher verlangt es keine Bestätigung. 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 mark_email_read.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

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"
    },
    "message_id": {
      "description": "The ID of one message to mark.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 20 messages to mark.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "unread": {
      "description": "true marks them as unread (default false: as read).",
      "type": "boolean"
    }
  },
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für m365_mark_email_read. 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.

{
  "message_id": "AAMkAGdemo-message-1"
}

Windows