İçeriğe geç
Tüm araçlar

m365_move_email

Microsoft 365 · macOS · Windows

Etki: yazma. 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 hesabındaki e-postaların dosyalamak, arşivlemek veya düzenlemek için Exchange sunucusunda başka bir klasöre taşınmasını istediğinde bunu kullanın. İletileri message_id (bir tane) veya message_ids (en çok 50) ile adlandırın; kimlikler m365_list_emails, m365_search_emails veya m365_read_email çıktısındandır; ya da tüm bir konuşmayı conversation_id ile (m365_list_emails veya m365_search_emails çıktısından): o zaman yalnızca source_folder (varsayılan inbox) içindeki iletileri taşınır; all_folders=true olmadıkça Sent Items, Drafts veya diğer klasörlerdeki kopyaları asla taşınmaz. destination, m365_list_email_folders çıktısından bir klasör kimliği, adı veya yoludur ya da inbox, archive, deleteditems, junkemail. Önce önizleme gösterir; taşımak için confirm=true ayarlayın. Bir ileti yalnızca ikinci bir okuma onu hedefte gösterdiğinde ve eski kimliğinde artık bulunmadığında taşınmış sayılır; taşınan iletinin yeni bir kimliği olur (new_id). Microsoft 365 Mail.ReadWrite iznini gerektirir: bu izin istenmeden önce bağlanmış bir hesap yeniden bağlanana kadar consent_required yanıtı verir. Mac'in Mail uygulamasındaki posta için move_email kullanın.

Zorunlu girdiler

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 bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

İ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"
    },
    "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"
}

Belge örneği

m365_move_email 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.

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

Windows

Amaç

Kullanıcı Microsoft 365 / Outlook hesabındaki e-postaların dosyalamak, arşivlemek veya düzenlemek için Exchange sunucusunda başka bir klasöre taşınmasını istediğinde bunu kullanın. İletileri message_id (bir tane) veya message_ids (en çok 50) ile adlandırın; kimlikler m365_list_emails, m365_search_emails veya m365_read_email çıktısındandır; ya da tüm bir konuşmayı conversation_id ile (m365_list_emails veya m365_search_emails çıktısından): o zaman yalnızca source_folder (varsayılan inbox) içindeki iletileri taşınır; all_folders=true olmadıkça Sent Items, Drafts veya diğer klasörlerdeki kopyaları asla taşınmaz. destination, m365_list_email_folders çıktısından bir klasör kimliği, adı veya yoludur ya da inbox, archive, deleteditems, junkemail. Önce önizleme gösterir; taşımak için confirm=true ayarlayın. Bir ileti yalnızca ikinci bir okuma onu hedefte gösterdiğinde ve eski kimliğinde artık bulunmadığında taşınmış sayılır; taşınan iletinin yeni bir kimliği olur (new_id). Microsoft 365 Mail.ReadWrite iznini gerektirir: bu izin istenmeden önce bağlanmış bir hesap yeniden bağlanana kadar consent_required yanıtı verir. Bu PC'deki klasik Outlook uygulamasındaki posta için outlook_move_email kullanın.

Zorunlu girdiler

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 bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

İngilizce kanonik teknik şema — 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"
}

Belge örneği

m365_move_email 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.

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