list_emails
E-posta · macOS
Etki: okuma. Durum: koşullu kullanılabilir.
“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.
macOS
Amaç
Kullanıcı bu Mac'teki gelen kutusunu görmek veya sınıflandırmak istediğinde bunu kullanın (Apple Mail; Mail.app'e eklenmiş iCloud, Gmail, IMAP veya Exchange hesabı olabilir). E-posta başlıklarını (konu, gönderen, tarih, okunmamış durumu) listeler; tam gövde için read_email(message_id) çağırın. Mail.app'e eklenmemiş bir Microsoft 365 posta kutusu için m365_list_emails kullanın. ÖNEMLİ: 2 veya daha fazla hesabı olan makinelerde account=<name> (list_email_accounts sonucundan) ile çağırın. Belirtilmezse ve hızlı dizin yanıt veremezse list_emails tüm hesapları taramak yerine hesap listesini döndürür; tüm hesapları tek çağrıda taramanın zaman sınırı yoktur ve Mail'i diğer istekler için de engelleyebilir (#2268). Tam olarak 1 hesap varsa bu durumdan etkilenmez. Sayfalandırmayı destekler: sonuçları sayfalamak için offset kullanın (ör. limit=20 ile ikinci sayfa için offset=20). limit parametresi çağrı başına en fazla 50 olabilir (varsayılan 20); daha fazlasını okumak için daha yüksek limit istemek yerine offset ile sayfalayı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.
İngilizce kanonik teknik şema — macOS
{
"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"
}Belge örneği
list_emails 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.
{
"limit": 5
}