Compartilhar via


Atualizar copilotAdminLimitedMode

Importante

As APIs na /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 .

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.

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.

Importante

Em cenários delegados com contas escolares ou profissionais, tem de ser atribuída ao utilizador com sessão iniciada a função de Administrador Global 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 O ID de um grupo de Microsoft Entra, para o qual o valor de isEnabledForGroup é aplicado. O valor padrão é null. Se isEnabledForGroup estiver definido como true, o groupId valor tem de ser fornecido para que o modo limitado Copilot nas reuniões do Teams seja ativado para os membros do grupo. Opcional.
isEnabledForGroup Booliano Permite que o utilizador esteja no modo limitado para Copilot em reuniões do Teams. Quando copilotAdminLimitedMode=true, os utilizadores neste modo podem fazer perguntas, mas a Copilot não responde a determinadas perguntas relacionadas com inferir emoções, comportamentos ou julgamentos. Quando copilotAdminLimitedMode=false, responde a todos os tipos de perguntas fundamentadas na conversação da reunião. O valor padrão é false.

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.

Esta API também pode devolver mais códigos http status, tais 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"
}