m365_mark_email_read

Microsoft 365 · macOS · Windows

効果: 書き込み. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

ユーザーが Microsoft 365 / Outlook アカウントのメールを既読にしたいとき、または unread=true で未読にしたいときに使います。すでに対応したものを記録したり、あとでメッセージに戻れるようにしたりする用途です。メッセージは、m365_list_emails、m365_search_emails、m365_read_email から得た message_id（1 件）または message_ids（最大 20 件）で指定します。メッセージがマークされたとみなされるのは、2 回目の読み取りで新しい状態が確認できた場合だけです。何も送信、移動、削除しないため、確認は求めません。Microsoft 365 の権限 Mail.ReadWrite が必要です。この権限が要求される前に接続されたアカウントは、再接続するまで consent_required を返します。Mac の Mail アプリのメールには mark_email_read を使ってください。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の 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"
    },
    "message_id": {
      "description": "The ID of one message to mark.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 20 messages to mark.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "unread": {
      "description": "true marks them as unread (default false: as read).",
      "type": "boolean"
    }
  },
  "type": "object"
}

ドキュメント例

m365_mark_email_read のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "message_id": "AAMkAGdemo-message-1"
}

Windows

目的

ユーザーが Microsoft 365 / Outlook アカウントのメールを既読にしたいとき、または unread=true で未読にしたいときに使います。すでに対応したものを記録したり、あとでメッセージに戻れるようにしたりする用途です。メッセージは、m365_list_emails、m365_search_emails、m365_read_email から得た message_id（1 件）または message_ids（最大 20 件）で指定します。メッセージがマークされたとみなされるのは、2 回目の読み取りで新しい状態が確認できた場合だけです。何も送信、移動、削除しないため、確認は求めません。Microsoft 365 の権限 Mail.ReadWrite が必要です。この権限が要求される前に接続されたアカウントは、再接続するまで consent_required を返します。この PC のクラシック Outlook アプリのメールには outlook_mark_email_read を使ってください。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の 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"
    },
    "message_id": {
      "description": "The ID of one message to mark.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 20 messages to mark.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "unread": {
      "description": "true marks them as unread (default false: as read).",
      "type": "boolean"
    }
  },
  "type": "object"
}

ドキュメント例

{
  "message_id": "AAMkAGdemo-message-1"
}