list_emails

macOS

Finalidade

Use isto quando o usuário quiser ver ou fazer a triagem de sua caixa de entrada neste Mac (Apple Mail — qualquer conta adicionada ao Mail. app: iCloud, Gmail, IMAP, Exchange). Lista cabeçalhos de e-mail (assunto, remetente, data, não lido); chame read_email(message_id) para o corpo inteiro. Para uma caixa de correio do Microsoft 365 NOT adicionada ao Mail. app, use m365_list_emails. IMPORTANT: em máquinas com mais de 2 contas, chame com account=<nome> (de list_email_accounts) (account=<name>). Sem ele, e quando o índice rápido não consegue responder, list_emails retorna a lista de contas em vez de verificar todas elas — a verificação de todas as contas em uma chamada não tem limite de tempo e pode bloquear o Mail para outras solicitações também (#2268). Exatamente 1 conta não é afetada. Suporta paginação: use deslocamento para paginar os resultados (por exemplo, deslocamento = 20 para a página 2 com limite = 20). O parâmetro limit é limitado a 50 por chamada (padrão 20); para ler mais, página com deslocamento em vez de solicitar um limite maior.

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": {
      "type": "string"
    },
    "limit": {
      "default": "20",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "offset": {
      "default": "0",
      "minimum": 0,
      "type": "integer"
    },
    "unread_only": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

Exemplo documental

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

{
  "limit": 5
}