m365_mark_email_read

Microsoft 365 · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Используйте, когда пользователю нужно пометить письма его аккаунта Microsoft 365 / Outlook как прочитанные или, с unread=true, как непрочитанные: чтобы отметить уже обработанное или вернуться к письму позже. Укажите сообщения через message_id (одно) или message_ids (до 20) из m365_list_emails, m365_search_emails или m365_read_email. Сообщение считается помеченным только тогда, когда повторное чтение показывает новое состояние. Ничего не отправляется, не перемещается и не удаляется, поэтому подтверждение не запрашивается. Нужно разрешение Microsoft 365 Mail.ReadWrite: аккаунт, подключённый до того, как оно запрашивалось, отвечает consent_required, пока не будет подключён заново. Для почты в приложении «Почта» на Mac используйте 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, как непрочитанные: чтобы отметить уже обработанное или вернуться к письму позже. Укажите сообщения через message_id (одно) или message_ids (до 20) из m365_list_emails, m365_search_emails или m365_read_email. Сообщение считается помеченным только тогда, когда повторное чтение показывает новое состояние. Ничего не отправляется, не перемещается и не удаляется, поэтому подтверждение не запрашивается. Нужно разрешение Microsoft 365 Mail.ReadWrite: аккаунт, подключённый до того, как оно запрашивалось, отвечает consent_required, пока не будет подключён заново. Для почты в классическом приложении 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"
}