search_emails

macOS

Amaç

Kullanıcı bu Mac'te belirli e-postaları bulmak istediğinde bunu kullanın (Apple Mail; Mail.app'e eklenmiş herhangi bir hesap). Varsayılan olarak konu ve gönderende arar; ileti gövdesinde de aramak için scope="body" veya scope="all" iletin (yanıttaki search_coverage değerine bakın; yerel dizin oluşturulurken gövde araması kısmi olabilir). Mail.app'e eklenmemiş bir Microsoft 365 posta kutusu için m365_search_emails kullanın. ÖNEMLİ: 2 veya daha fazla hesap bulunan makinelerde account=<name> değerini (list_email_accounts sonucundan) iletin. Bu değer olmadan ve hızlı dizin yanıt veremediğinde search_emails tüm hesapları taramak yerine hesap listesini döndürür; tüm hesapları tek çağrıda taramanın süre sınırı yoktur ve Mail'i diğer istekler için de engelleyebilir. Tam olarak 1 hesap varsa bu durum geçerli değildir.

Zorunlu girdiler

• query

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"
    },
    "limit": {
      "default": "20",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "scope": {
      "default": "metadata",
      "description": "\"metadata\" (default, subject+sender — fast, unchanged behavior), \"body\" (message body only, via a local index — see search_coverage in the response), or \"all\" (subject+sender+body).",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Belge örneği

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

{
  "query": "launch checklist"
}