Canal patch

Namespace: microsoft.graph

Atualize as propriedades do canal especificado.

Observação

Quando usada com permissões de aplicativo, essa API é medida. Ele dá suporte ao model=A modelo de pagamento. Para obter detalhes, consulte Modelos de pagamento. Se você não especificar um modelo de pagamento em sua consulta, o modo de avaliação padrão será usado.

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

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

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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.

Essa API dá suporte a permissões de administrador. Administradores globais e administradores de serviços do Microsoft Teams podem acessar equipes das quais não são membros.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) ChannelSettings.ReadWrite.All Directory.ReadWrite.All, Group.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application ChannelSettings.ReadWrite.Group ChannelSettings.ReadWrite.All, Directory.ReadWrite.All, Group.ReadWrite.All

Observação

  • A permissão ChannelSettings.ReadWrite.Group usa o consentimento específico do recurso.
  • As permissões Group.ReadWrite.All e Directory.ReadWrite.All têm suporte apenas para compatibilidade com versões anteriores. Recomendamos que você atualize suas soluções para usar uma permissão alternativa listada na tabela anterior e evite usar essas permissões daqui para frente.

Solicitação HTTP

PATCH /teams/{team-id}/channels/{channel-id}

Cabeçalhos de solicitação

Cabeçalho Valor
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

No corpo da solicitação, fornça uma representação JSON do objeto canal.

Nota: Não é possível atualizar o membershipType valor de um canal existente.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Limites de limitação específicos do serviço do Microsoft Graph