mark_email_read

macOS

Scopo

Da usare quando l'utente vuole che le e-mail in Apple Mail (Mail.app) del Mac siano contrassegnate come lette, o come non lette con unread=true: per annotare ciò che è già stato gestito, o per tornare a un messaggio più tardi. Indica i messaggi con message_id (uno) o message_ids (fino a 20), da list_emails, search_emails o read_email, e passa account= in modo che vengano trovati nell'account giusto. Un messaggio conta come contrassegnato solo quando una seconda lettura mostra il nuovo stato. Non viene inviato, spostato né eliminato nulla, quindi non chiede conferma. Per la posta di un account Microsoft 365 usa m365_mark_email_read.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

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

Esempio documentale

Esempio di documentazione per mark_email_read. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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