list_emails

macOS

목적

사용자가 이 Mac의 받은 편지함을 보거나 정리하려 할 때 사용합니다. Apple Mail, 즉 Mail.app에 추가된 iCloud, Gmail, IMAP, Exchange 등 모든 계정을 지원합니다. 이메일 헤더(제목, 발신자, 날짜, 읽지 않음)를 나열하며 전체 본문은 read_email(message_id)로 읽으세요. Mail.app에 추가되지 않은 Microsoft 365 사서함에는 m365_list_emails를 사용하세요. IMPORTANT: 계정이 2개 이상인 머신에서는 list_email_accounts에서 얻은 account=<name>과 함께 호출하세요. 이를 생략하고 빠른 인덱스로 응답할 수 없으면 모든 계정을 스캔하지 않고 계정 목록을 반환합니다. 한 번에 모든 계정을 스캔하면 시간 제한이 없고 다른 요청의 Mail도 차단할 수 있습니다(#2268). 계정이 정확히 하나면 영향이 없습니다. 페이지 매김을 지원합니다. 결과를 넘겨보려면 offset을 사용하세요(예: limit=20일 때 두 번째 페이지는 offset=20). limit은 호출당 최대 50이고 기본값은 20입니다. 더 읽으려면 더 큰 limit을 요청하지 말고 offset으로 페이지를 넘기세요.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

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

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

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

문서 예시

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

{
  "limit": 5
}