Обновление copilotAdminLimitedMode

Важно!

Api в /beta версии могут быть изменены. Использование этих API в производственных приложениях не поддерживается.

Обновите свойства объекта copilotAdminLimitedMode .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ❌ ❌ ❌

Разрешения

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

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) CopilotSettings-LimitedMode.ReadWrite Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Не поддерживается. Не поддерживается.

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена роль глобального администратора Microsoft Entra.

HTTP-запрос

PATCH https://graph.microsoft.com/v1.0/copilot/admin/settings/limitedMode

PATCH https://graph.microsoft.com/beta/copilot/admin/settings/limitedMode

Заголовки запросов

Имя Описание
Authorization Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

Свойство Тип Описание
groupId String Идентификатор Microsoft Entra группы, к которой применяется значение isEnabledForGroup . Значение по умолчанию — null. Если isEnabledForGroup задано значение true, groupId значение должно быть указано для включения ограниченного режима Copilot в собраниях Teams для участников группы. Необязательный параметр.
isEnabledForGroup Логический Позволяет пользователю находиться в ограниченном режиме для copilot в собраниях Teams. В copilotAdminLimitedMode=trueэтом режиме пользователи могут задавать любые вопросы, но Copilot не отвечает на некоторые вопросы, связанные с выводом эмоций, поведения или суждений. Если copilotAdminLimitedMode=falseзадано значение , он отвечает на все типы вопросов, обоснованных для беседы на собрании. Значение по умолчанию — false.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект copilotAdminLimitedMode в теле отклика.

Этот API также может возвращать дополнительные коды состояния HTTP, такие как 403 Forbidden, 500 Internal Server Errorи 429 Too Many Requests.

Пример

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/v1.0/copilot/admin/settings/limitedMode
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.copilotAdminLimitedMode",
  "isEnabledForGroup": true,
  "groupId": "4c563cdf-0efa-44c5-a384-dbf57db277df"
}

PATCH https://graph.microsoft.com/beta/copilot/admin/settings/limitedMode
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.copilotAdminLimitedMode",
  "isEnabledForGroup": true,
  "groupId": "4c563cdf-0efa-44c5-a384-dbf57db277df"
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "isEnabledForGroup": true,
  "groupId": "4c563cdf-0efa-44c5-a384-dbf57db277df"
}
  • Last updated on