list_emails

macOS

Scopo

Utilizzalo quando l'utente desidera visualizzare o valutare la propria casella di posta su questo Mac (Apple Mail: qualsiasi account aggiunto a Mail.app: iCloud, Gmail, IMAP, Exchange). Elenca le intestazioni delle email (oggetto, mittente, data, non letto); chiama read_email(message_id) per il corpo intero. Per una casella di posta Microsoft 365 NOT aggiunta a Mail.app, utilizzare m365_list_emails. IMPORTANT: su macchine con 2+ account, chiama con account=<nome> (da list_email_accounts). Senza di esso, e quando l'indice veloce non può rispondere, list_emails restituisce l'elenco degli account invece di scansionarli tutti: la scansione di ogni account in una chiamata non ha limiti di tempo e può bloccare Mail anche per altre richieste (#2268). Esattamente 1 account non è interessato. Supporta l'impaginazione: utilizza l'offset per sfogliare i risultati (ad esempio offset=20 per la pagina 2 con limite=20). Il parametro limite è limitato a 50 per chiamata (default 20); per saperne di più, pagina con offset anziché richiedere un limite maggiore. Elementi tecnici invariati: account=<name>.

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.

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

Esempio documentale

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

{
  "limit": 5
}