m365_mark_email_read

Microsoft 365 · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

À utiliser lorsque l’utilisateur veut que des e-mails de son compte Microsoft 365 / Outlook 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 m365_list_emails, m365_search_emails ou m365_read_email. 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. Nécessite l’autorisation Microsoft 365 Mail.ReadWrite : un compte connecté avant qu’elle soit demandée répond consent_required jusqu’à sa reconnexion. Pour le courrier de l’app Mail du Mac, utilisez 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.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour m365_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.

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

Windows