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 hepsi dahildir. Mail.app'e eklenmemiş, yalnızca Graph üzerinden erişilen bir Microsoft 365 posta kutusu için bunun yerine m365_list_emails kullanın. Bir hesabı tamamen listelemek için account=<name> iletin (list_email_accounts içinden); onsuz tüm hesaplar gezilir ve bu macOS 15+ üzerinde yavaş olabilir. İleti sayıları varsayılan olarak kapalıdır (IMAP'te yavaştır); klasör başına okunmamış/toplam sayısını eklemek için include_counts=true iletin (adı verilen hesap diskten çözümlenirse Mail'in yerel dizininden, aksi halde Mail.app'in kendi canlı sayımından; her iki durumda da yanıttaki unread_count_note bölümüne bakın).

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": {
      "description": "Mail.app account whose folder tree to list (from list_email_accounts). Defaults to every account.",
      "type": "string"
    },
    "include_counts": {
      "default": "false",
      "description": "Include the message count of each folder. Slower, because each folder has to be counted.",
      "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.

{}