m365_mark_email_read

Microsoft 365 · macOS · Windows

Effect: schrijven. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Gebruik dit wanneer de gebruiker e-mails van zijn Microsoft 365 / Outlook-account als gelezen wil markeren, of als ongelezen met unread=true: om aan te geven wat al is afgehandeld, of om later op een bericht terug te komen. Noem de berichten met message_id (één) of message_ids (maximaal 20), uit m365_list_emails, m365_search_emails of m365_read_email. Een bericht telt pas als gemarkeerd wanneer een tweede lezing de nieuwe status toont. Er wordt niets verzonden, verplaatst of verwijderd, dus er wordt om geen bevestiging gevraagd. Vereist de Microsoft 365-machtiging Mail.ReadWrite: een account dat is gekoppeld voordat erom werd gevraagd, antwoordt consent_required totdat het opnieuw is gekoppeld. Gebruik mark_email_read voor mail in de Mail-app van de Mac.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor m365_mark_email_read. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows

Doel

Gebruik dit wanneer de gebruiker e-mails van zijn Microsoft 365 / Outlook-account als gelezen wil markeren, of als ongelezen met unread=true: om aan te geven wat al is afgehandeld, of om later op een bericht terug te komen. Noem de berichten met message_id (één) of message_ids (maximaal 20), uit m365_list_emails, m365_search_emails of m365_read_email. Een bericht telt pas als gemarkeerd wanneer een tweede lezing de nieuwe status toont. Er wordt niets verzonden, verplaatst of verwijderd, dus er wordt om geen bevestiging gevraagd. Vereist de Microsoft 365-machtiging Mail.ReadWrite: een account dat is gekoppeld voordat erom werd gevraagd, antwoordt consent_required totdat het opnieuw is gekoppeld. Gebruik outlook_mark_email_read voor mail in de klassieke Outlook-app op deze pc.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — Windows

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

Documentatievoorbeeld

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