proton_list_emails

Proton Mail · macOS · Windows

Efeito: leitura. 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

Lista as mensagens mais recentes de uma pasta de uma conta do Proton Mail, das mais novas para as mais antigas: id, remetente, destinatários, assunto, data, tamanho e flags. `folder` é INBOX por padrão; o Bridge dá nome às restantes (Sent, Archive, All Mail, Folders/…, Labels/…). Paginado com limit e offset. Nada é marcado como lido. Lê do Proton Mail Bridge neste computador; requer um plano do Proton que inclua o Bridge, com o Bridge em execução.

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": "The Proton Mail account: its address, as proton_connect lists it. Optional when one account is connected.",
      "type": "string"
    },
    "folder": {
      "description": "Folder name (default INBOX).",
      "type": "string"
    },
    "limit": {
      "description": "Messages per page (default 50, max 200).",
      "type": "integer"
    },
    "offset": {
      "description": "Messages to skip (default 0).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Exemplo documental

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

{
  "account": "alex@example.com",
  "folder": "INBOX",
  "limit": 20
}

Windows