m365_mark_email_read

Microsoft 365 · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Use quando o usuário quiser que e-mails da sua conta do Microsoft 365 / Outlook 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 m365_list_emails, m365_search_emails ou m365_read_email. 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. Requer a permissão Mail.ReadWrite do Microsoft 365: uma conta conectada antes de ela ser solicitada responde consent_required até ser conectada de novo. Para e-mails do app Mail do Mac, use 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.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para m365_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.

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

Windows