m365_mark_email_read

Microsoft 365 · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Da usare quando l'utente vuole che le e-mail del suo account Microsoft 365 / Outlook 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 m365_list_emails, m365_search_emails o m365_read_email. 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. Richiede il permesso Mail.ReadWrite di Microsoft 365: un account collegato prima che venisse richiesto risponde consent_required finché non viene collegato di nuovo. Per la posta nell'app Mail del Mac usa 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.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per m365_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.

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

Windows