m365_list_email_folders

Microsoft 365 · macOS · Windows

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

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

macOS

Назначение

Используйте, когда пользователю нужны почтовые папки его аккаунта Microsoft 365 / Outlook в том виде, как они есть на сервере Exchange: каждая папка и подпапка с id, именем, путём (Parent/Child), parent_id, общим числом и числом непрочитанных. id, имя или путь папки передаются в m365_list_emails и m365_search_emails (folder), m365_create_email_folder (parent) и m365_move_email (destination). Для папок аккаунта в приложении «Почта» на Mac используйте list_email_folders.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

Пример документации для m365_list_email_folders. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{}

Windows

Назначение

Используйте, когда пользователю нужны почтовые папки его аккаунта Microsoft 365 / Outlook в том виде, как они есть на сервере Exchange: каждая папка и подпапка с id, именем, путём (Parent/Child), parent_id, общим числом и числом непрочитанных. id, имя или путь папки передаются в m365_list_emails и m365_search_emails (folder), m365_create_email_folder (parent) и m365_move_email (destination). Для почты в классическом приложении Outlook на этом ПК используйте outlook_list_emails.

Обязательные входные данные

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

{}