Compartilhar via


Atualizar copilotAdminLimitedMode

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualize as propriedades de um objeto copilotAdminLimitedMode .

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Nota: É necessária permissão de administrador global ou leitor global para chamar esta API.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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.

Solicitação HTTP

PATCH /copilot/admin/settings/limitedMode

Cabeçalhos de solicitação

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

Corpo da solicitação

Propriedade Tipo Descrição
isEnabledForGroup Booliano Permite que o utilizador esteja no modo limitado para Copilot no Teams reuniões. Quando copilotLimitedMode=true, os utilizadores neste modo podem fazer perguntas, mas Copilot não responde a determinadas perguntas relacionadas com inferir emoções, comportamentos ou julgamentos. Quando copilotLimitedMode=false, o modo atual para Copilot, responde a qualquer tipo de perguntas fundamentadas na conversação da reunião. O valor padrão é false.
groupId Cadeia de caracteres O ID de um grupo de Microsoft Entra, do qual o valor de isEnabledForGroup é aplicado aos respetivos membros. O valor padrão é null. Esse parâmetro é opcional. Se isEnabledForGroup estiver definido como verdadeiro, o groupId valor tem de ser fornecido para que o copilotLimitedMode seja ativado para os membros do grupo.

Resposta

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

A API pode devolver códigos de status HTTP adicionais, como 403 Forbidden, 500 Internal Server Errorou 429 Too Many Requests.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
  "@odata.type": "#microsoft.graph.copilotAdminLimitedMode",
  "isEnabledForGroup": "Boolean",
  "groupId": "String"
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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