list_email_folders

macOS

Amaç

Apple Mail (Mail.app) hesaplarının iç içe alt klasörler dahil tam klasör (posta kutusu) ağacını listeler. move_email(target_mailbox=...) ve list_emails(mailbox=...) araçlarının beklediği kesin klasör adlarını bulmak için kullanın. Mail.app'e eklenmiş Outlook.com, Exchange, Gmail, iCloud ve IMAP hesaplarının tümü dahildir. Mail.app'e eklenmemiş, yalnızca Graph kullanan bir Microsoft 365 posta kutusu için bunun yerine m365_list_emails kullanın. Tek bir hesabı eksiksiz listelemek için account=<name> (list_email_accounts sonucundan) iletin; belirtilmezse tüm hesaplar dolaşılır ve bu macOS 15+ üzerinde yavaş olabilir. İleti sayıları varsayılan olarak kapalıdır (IMAP üzerinde yavaştır); klasör başına okunmamış/toplam sayılarını eklemek için include_counts=true iletin.

Zorunlu girdiler

Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

• Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.

{
  "properties": {
    "account": {
      "type": "string"
    },
    "include_counts": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

Belge örneği

list_email_folders için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{}