m365_search_emails

Microsoft 365 · macOS · Windows

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ı, Microsoft 365 / Outlook posta kutusundaki e-postaları bulut üzerinden bulmak istediğinde bunu kullanın; bağlı bir M365 hesabı gerekir. Varsayılan olarak gönderen, konu VE gövdede arar (Microsoft Graph'in kendi $search varsayılanı). Yalnızca gönderen/konuda aramak için (daha hızlı, gövde taraması yok) scope="metadata", yalnızca ileti gövdesinde aramak için scope="body" iletin. Tek bir klasörde aramak için folder iletin (iyi bilinen bir ad veya m365_list_email_folders çıktısından bir kimlik, ad veya yol). Mac'in Mail.app uygulamasına eklenmiş hesaplar için search_emails kullanın.

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.

İngilizce kanonik teknik şema — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "folder": {
      "description": "Search only this folder: a well-known name, or an id, name or path from m365_list_email_folders. Leave it out to search the whole mailbox.",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 20, max 50)",
      "type": "integer"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:alice@contoso.com', 'subject:invoice'",
      "type": "string"
    },
    "scope": {
      "description": "\"all\" (default — sender+subject+body, today's behavior), \"metadata\" (sender+subject only), or \"body\" (body only).",
      "enum": [
        "metadata",
        "body",
        "all"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Belge örneği

m365_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"
}

Windows