read_email

macOS

Amaç

Kullanıcı, Mac'teki Apple Mail uygulamasında bulunan bir e-postanın tam içeriğini istediğinde bunu kullanın (list_emails/search_emails tarafından döndürülen ileti ID değeri). m365_list_emails tarafından döndürülen Microsoft 365 ileti ID değeri için m365_read_email kullanın. Aramanın tüm hesapları taramak yerine tek bir hesabı hedeflemesi için account= (biliniyorsa mailbox= da; ikisi de list_emails/search_emails tarafından döndürülür) iletin. Paralel değil, sıralı olarak çağırın; eşzamanlı çağrılar Mail.app uygulamasının JXA kilidinin arkasında sıraya girer ve sonraki çağrılar zaman aşımına uğrar. Performans: Gövdeyi getirmek temel gecikme kaynağıdır (yavaş IMAP üzerinde ortalama 20 sn). Gövdeyi atlamak ve yalnızca meta verileri hızlıca almak için include_body=false iletin. HTML temizlendikten sonra gövdeyi N karakterle sınırlamak için max_body_chars=N iletin (varsayılan 30000; 0=sınırsız). Getirme 2 sn'den uzun sürerse yanıt body_fetch_ms, atlanırsa body_omitted=true, kesilirse body_truncated_at=N içerir. Gövde bu Mac'te önbelleğe alınmamışsa read_email, Mail uygulamasına gövdeyi getirtmek yerine (bu yavaş olabilir ve Mail'i meşgul edebilir) meta verileri body_omitted=true ve body_omit_reason="not_downloaded" ile döndürür (iCloud/IMAP iyileştirilmiş depolama). Kullanıcı yine de isterse, Mail'in gövdeyi IMAP üzerinden şimdi indirip döndürmesi için force_download=true ile yeniden deneyin (yaklaşık 60 sn'ye kadar bekler). Varsayılan olarak kapalıdır; Mail bekleme süresindeyken yok sayılır.

Zorunlu girdiler

• message_id

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İ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"
    },
    "force_download": {
      "default": "false",
      "type": "boolean"
    },
    "include_body": {
      "default": "true",
      "type": "boolean"
    },
    "mailbox": {
      "type": "string"
    },
    "max_body_chars": {
      "default": "30000",
      "minimum": 0,
      "type": "integer"
    },
    "message_id": {
      "type": "string"
    }
  },
  "required": [
    "message_id"
  ],
  "type": "object"
}

Belge örneği

read_email 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.

{
  "message_id": "demo-message-001"
}