move_email

이메일 · macOS

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

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

macOS

목적

이메일을 다른 메일함으로 이동합니다(중첩된 대상 폴더는 이름으로 찾습니다). 모든 계정을 스캔하지 않고 한 계정에서만 메시지를 찾도록 account=(list_emails/search_emails가 반환)를 전달하세요. 전달하지 않으면 계정이 여러 개인 Mac에서는 느려지고 대량 이동 시 시간 초과가 날 수 있습니다. 메시지가 있는 폴더를 알고 있다면 mailbox=(목록의 `mailbox` 필드)도 함께 전달하여 그 폴더를 먼저 검색하게 하세요. Exchange 계정에서는 Mail이 서버로 이동을 확인할 수 없으므로 moved=false와 status server_unconfirmed로 응답합니다. 그 메일함에는 m365_move_email을 사용하세요.

필수 입력

message_id
target_mailbox

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

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

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

영문 정식 기술 스키마 — macOS

{
  "properties": {
    "account": {
      "description": "Mail.app account the message lives in (returned alongside the id). Pass it so the message is found in the right account.",
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "description": "Set to true to actually move the message. Defaults to false.",
      "type": "boolean"
    },
    "mailbox": {
      "description": "Folder the message is in TODAY, before the move. Passing it skips searching the other folders.",
      "type": "string"
    },
    "message_id": {
      "description": "The message id returned by list_emails or search_emails. Accepts the bare id or the <angle-bracketed> form.",
      "type": "string"
    },
    "target_mailbox": {
      "description": "Destination folder, by name (see list_email_folders). Nested folders are found by their own name, not by a path.",
      "type": "string"
    }
  },
  "required": [
    "message_id",
    "target_mailbox"
  ],
  "type": "object"
}

문서 예시

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

{
  "confirm": false,
  "message_id": "demo-message-001",
  "target_mailbox": "Archive"
}