mark_email_read

macOS

Finalidade

Use quando o usuário quiser que e-mails do Apple Mail (Mail.app) do Mac sejam marcados como lidos, ou como não lidos com unread=true: para anotar o que já foi tratado ou para voltar a uma mensagem mais tarde. Indique as mensagens com message_id (uma) ou message_ids (até 20), de list_emails, search_emails ou read_email, e passe account= para que sejam encontradas na conta certa. Uma mensagem só conta como marcada quando uma segunda leitura mostra o novo estado. Nada é enviado, movido ou excluído, então não pede confirmação. Para e-mails de uma conta do Microsoft 365, use m365_mark_email_read.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

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

Exemplo documental

Exemplo de documentação para mark_email_read. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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