m365_search_emails

Microsoft 365 · macOS · Windows

효과: 읽기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

사용자가 클라우드를 통해 Microsoft 365 / Outlook 사서함의 이메일을 찾으려고 할 때 사용합니다. 연결된 M365 계정이 필요합니다. 기본적으로 보낸 사람, 제목, 본문을 모두 검색합니다(Microsoft Graph의 $search 기본 동작). 보낸 사람/제목만 검색하려면(더 빠르고 본문을 스캔하지 않음) scope="metadata"를, 본문만 검색하려면 scope="body"를 전달하세요. 폴더 하나만 검색하려면 folder를 전달하세요(잘 알려진 이름, 또는 m365_list_email_folders의 id, 이름 또는 경로). Mac의 Mail.app에 추가된 계정에는 search_emails를 사용하세요.

필수 입력

query

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

영문 정식 기술 스키마 — 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"
}

문서 예시

m365_search_emails 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "query": "launch checklist"
}

Windows

목적

키워드, 보낸 사람 또는 제목으로 Microsoft 365 이메일을 검색합니다. 폴더 하나만 검색하려면 folder를 전달하세요(잘 알려진 이름, 또는 m365_list_email_folders의 id, 이름 또는 경로).

필수 입력

query

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

영문 정식 기술 스키마 — Windows

{
  "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": "number"
    },
    "query": {
      "description": "Search query, e.g. 'budget Q2', 'from:alice@contoso.com', 'subject:invoice'",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

문서 예시

{
  "query": "launch checklist"
}