m365_move_email

Microsoft 365 · macOS · Windows

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

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

macOS

목적

사용자가 Microsoft 365 / Outlook 계정의 이메일을 정리, 보관 또는 분류하기 위해 Exchange 서버의 다른 폴더로 옮기려고 할 때 사용합니다. message_id(하나) 또는 message_ids(최대 50개)로 메시지를 지정하며 m365_list_emails, m365_search_emails 또는 m365_read_email에서 가져옵니다. 또는 conversation_id(m365_list_emails 또는 m365_search_emails에서 가져옴)로 대화 전체를 지정하며, 이 경우 source_folder(기본값 inbox)에 있는 메시지만 이동하고 all_folders=true가 아닌 한 보낸 편지함, 임시 보관함 또는 다른 폴더에 있는 사본은 이동하지 않습니다. destination은 m365_list_email_folders의 폴더 id, 이름 또는 경로, 또는 inbox, archive, deleteditems, junkemail입니다. 먼저 미리보기를 표시하며, 이동하려면 confirm=true로 설정하세요. 두 번째 읽기에서 메시지가 대상에 있고 이전 id에는 더 이상 없을 때만 이동된 것으로 간주하며, 이동된 메시지는 새 id를 받습니다(new_id). Microsoft 365 권한 Mail.ReadWrite가 필요합니다. 이 권한이 요청되기 전에 연결한 계정은 다시 연결할 때까지 consent_required로 응답합니다. Mac의 Mail 앱에 있는 메일에는 move_email을 사용하세요.

필수 입력

destination

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

권한 및 확인

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

이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 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"
    },
    "all_folders": {
      "description": "With conversation_id: true moves its messages from every folder, Sent Items and Drafts included (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Set to true to move (default: shows a preview only).",
      "type": "boolean"
    },
    "conversation_id": {
      "description": "Move the messages of this conversation that are in source_folder.",
      "type": "string"
    },
    "destination": {
      "description": "The folder to move them to: an id, name or path from m365_list_email_folders, or inbox, archive, deleteditems, junkemail.",
      "type": "string"
    },
    "message_id": {
      "description": "The ID of one message to move.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 50 messages to move.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source_folder": {
      "description": "With conversation_id: the folder its messages are moved from (default inbox). An id, name or path.",
      "type": "string"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

문서 예시

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

{
  "confirm": false,
  "destination": "archive",
  "message_id": "demo-message-001"
}

Windows

목적

사용자가 Microsoft 365 / Outlook 계정의 이메일을 정리, 보관 또는 분류하기 위해 Exchange 서버의 다른 폴더로 옮기려고 할 때 사용합니다. message_id(하나) 또는 message_ids(최대 50개)로 메시지를 지정하며 m365_list_emails, m365_search_emails 또는 m365_read_email에서 가져옵니다. 또는 conversation_id(m365_list_emails 또는 m365_search_emails에서 가져옴)로 대화 전체를 지정하며, 이 경우 source_folder(기본값 inbox)에 있는 메시지만 이동하고 all_folders=true가 아닌 한 보낸 편지함, 임시 보관함 또는 다른 폴더에 있는 사본은 이동하지 않습니다. destination은 m365_list_email_folders의 폴더 id, 이름 또는 경로, 또는 inbox, archive, deleteditems, junkemail입니다. 먼저 미리보기를 표시하며, 이동하려면 confirm=true로 설정하세요. 두 번째 읽기에서 메시지가 대상에 있고 이전 id에는 더 이상 없을 때만 이동된 것으로 간주하며, 이동된 메시지는 새 id를 받습니다(new_id). Microsoft 365 권한 Mail.ReadWrite가 필요합니다. 이 권한이 요청되기 전에 연결한 계정은 다시 연결할 때까지 consent_required로 응답합니다. 이 PC의 클래식 Outlook 앱에 있는 메일에는 outlook_move_email을 사용하세요.

필수 입력

destination

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

권한 및 확인

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

이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 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"
    },
    "all_folders": {
      "description": "With conversation_id: true moves its messages from every folder, Sent Items and Drafts included (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Set to true to move (default: shows a preview only).",
      "type": "boolean"
    },
    "conversation_id": {
      "description": "Move the messages of this conversation that are in source_folder.",
      "type": "string"
    },
    "destination": {
      "description": "The folder to move them to: an id, name or path from m365_list_email_folders, or inbox, archive, deleteditems, junkemail.",
      "type": "string"
    },
    "message_id": {
      "description": "The ID of one message to move.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 50 messages to move.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source_folder": {
      "description": "With conversation_id: the folder its messages are moved from (default inbox). An id, name or path.",
      "type": "string"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

문서 예시

{
  "confirm": false,
  "destination": "archive",
  "message_id": "demo-message-001"
}