Compartir a través de


Actualizar copilotAdminLimitedMode

Importante

Las API de la /beta versión están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción.

Actualice las propiedades de un objeto copilotAdminLimitedMode .

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) CopilotSettings-LimitedMode.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Importante

En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar el rol de administrador global Microsoft Entra.

Solicitud HTTP

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

Encabezados de solicitud

Nombre Descripción
Authorization Bearer {token}. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

Propiedad Tipo Descripción
groupId Cadena Identificador de un grupo de Microsoft Entra, al que se aplica el valor de isEnabledForGroup . El valor predeterminado es null. Si isEnabledForGroup se establece en true, el groupId valor debe proporcionarse para que el modo limitado Copilot de las reuniones de Teams esté habilitado para los miembros del grupo. Opcional.
isEnabledForGroup Booleano Permite que el usuario esté en modo limitado para Copilot en reuniones de Teams. Cuando copilotAdminLimitedMode=truees , los usuarios de este modo pueden formular cualquier pregunta, pero Copilot no responde a ciertas preguntas relacionadas con la inferencia de emociones, comportamientos o juicios. Cuando copilotAdminLimitedMode=false, responde a todos los tipos de preguntas que se fundamentan en la conversación de la reunión. El valor predeterminado es false.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto copilotAdminLimitedMode actualizado en el cuerpo de la respuesta.

Esta API también puede devolver más códigos de estado HTTP, como 403 Forbidden, 500 Internal Server Errory 429 Too Many Requests.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

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