mark_email_read

macOS

Objectif

À utiliser lorsque l’utilisateur veut que des e-mails d’Apple Mail (Mail.app) du Mac soient marqués comme lus, ou comme non lus avec unread=true : pour noter ce qui a déjà été traité, ou pour revenir plus tard à un message. Désignez les messages avec message_id (un) ou message_ids (jusqu’à 20), issus de list_emails, search_emails ou read_email, et passez account= pour qu’ils soient trouvés dans le bon compte. Un message est considéré comme marqué seulement lorsqu’une seconde lecture montre le nouvel état. Rien n’est envoyé, déplacé ni supprimé, donc aucune confirmation n’est demandée. Pour le courrier d’un compte Microsoft 365, utilisez m365_mark_email_read.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

{
  "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"
}

Exemple documentaire

Exemple de documentation pour mark_email_read. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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