list_email_folders

macOS

Scopo

Elenca l'albero completo delle cartelle (cassetta postale) per gli account Apple Mail (Mail.app), incluse le sottocartelle nidificate. Utilizzalo per scoprire i nomi esatti delle cartelle previsti da move_email(target_mailbox=...) e list_emails(mailbox=...). Sono inclusi tutti gli account Outlook.com, Exchange, Gmail, iCloud e IMAP aggiunti a Mail.app. Per una cassetta postale Microsoft 365 solo grafico non aggiunta a Mail.app, utilizzare invece m365_list_emails. Passa account=<nome> (da list_email_accounts) per enumerare completamente un account; senza di esso, ogni account viene camminato, il che può essere lento su macOS 15+. Il conteggio dei messaggi è disattivato per impostazione predefinita (lento su IMAP): passa include_counts=true per aggiungere non letti/totale per cartella. 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"
    },
    "include_counts": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

Esempio documentale

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

{}