mark_email_read

macOS

Zweck

Verwenden Sie es, wenn der Benutzer E-Mails in Apple Mail (Mail.app) auf dem Mac 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 list_emails, search_emails oder read_email, und übergeben Sie account=, damit sie im richtigen Konto gefunden werden. 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. Für E-Mails eines Microsoft-365-Kontos verwenden Sie m365_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.

{
  "properties": {
    "account": {
      "description": "Mail.app account the messages live in (returned alongside the id).",
      "type": "string"
    },
    "mailbox": {
      "description": "Folder the messages are in. Passing it skips searching the other folders.",
      "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 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.

{
  "mailbox": "INBOX",
  "message_id": "demo-message-1"
}