Atualizar copilotAdminLimitedMode

Importante

As APIs sob a /beta versão estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção.

Atualize as propriedades de um objeto copilotAdminLimitedMode .

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) CopilotSettings-LimitedMode.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Importante

Em cenários delegados com contas corporativas ou de estudante, o usuário conectado deve receber a função de Administrador Global do Microsoft Entra.

Solicitação HTTP

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

Cabeçalhos de solicitação

Nome Descrição
Authorization Bearer {token}. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

Propriedade Tipo Descrição
groupId Cadeia de caracteres A ID de um grupo do Microsoft Entra ao qual o valor de isEnabledForGroup é aplicado. O valor padrão é null. Se isEnabledForGroup estiver definido como true, o valor deverá ser fornecido para que o groupId modo limitado do Copilot nas reuniões do Teams seja habilitado para os membros do grupo. Opcional.
isEnabledForGroup Booliano Permite que o usuário esteja no modo limitado para o Copilot em reuniões do Teams. Quando copilotAdminLimitedMode=true, os usuários nesse modo podem fazer qualquer pergunta, mas o Copilot não responde a determinadas perguntas relacionadas à inferência de emoções, comportamento ou julgamentos. Quando copilotAdminLimitedMode=false, ele responde a todos os tipos de perguntas fundamentadas na conversa da reunião. O valor padrão é false.

Resposta

Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto copilotAdminLimitedMode atualizado no corpo da resposta.

Essa API também pode retornar mais códigos de status HTTP, como 403 Forbidden, 500 Internal Server Errore 429 Too Many Requests.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo a seguir mostra a resposta.

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

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