connect_m365_account

Microsoft 365 · macOS · Windows

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

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

macOS

Назначение

Подключает аккаунт Microsoft 365 (или добавляет ещё один, или выполняет вход заново). Первый вызов возвращает предпросмотр и ничего не запускает; confirm: true выдаёт код для входа. Вызовите снова после аутентификации на microsoft.com/devicelogin, чтобы завершить подключение. Передайте include_channel_messages: true, чтобы также читать сообщения каналов Teams и искать по ним — для этого разрешения нужен администратор вашей организации Microsoft 365; без его одобрения вход отклоняется, и аккаунт сохраняет текущий доступ.

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

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

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "account_type": {
      "description": "\"work\" (default): a work or school Microsoft 365 account — mail, calendar, contacts, Teams. \"personal\": an Outlook.com / Hotmail / Live account — mail, calendar and contacts only (Microsoft has no Teams chats or directory for personal accounts, and asking for them makes Microsoft refuse the sign-in as an 'expired code'). Ask the person which one it is when unsure.",
      "enum": [
        "work",
        "personal"
      ],
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to start the sign-in. Without it the call returns a preview and does nothing.",
      "type": "boolean"
    },
    "include_channel_messages": {
      "description": "Also request access to Teams channel messages and message search. Needs an administrator of the Microsoft 365 organization; without that approval this sign-in is refused and the account keeps its current access.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

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

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

{
  "confirm": false
}

Windows

Назначение

Подключает аккаунт Microsoft 365 (или добавляет ещё один, или выполняет вход заново). Первый вызов возвращает предпросмотр и ничего не запускает; confirm=true выдаёт код для входа, затем вызовите снова после аутентификации на microsoft.com/devicelogin, чтобы завершить. Передайте include_channel_messages: true, чтобы также читать сообщения каналов Teams и искать по ним — для этого разрешения нужен администратор вашей организации Microsoft 365; без его одобрения вход отклоняется, и аккаунт сохраняет текущий доступ.

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to start the sign-in. Without it, returns a preview.",
      "type": "boolean"
    },
    "include_channel_messages": {
      "description": "Also request access to Teams channel messages and message search. That permission needs an administrator of the Microsoft 365 organization; without that approval this sign-in is refused and the account keeps its current access.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

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

{
  "confirm": false
}