Atualizar conversationMemberUpdate conversationMember

Namespace: microsoft.graphNamespace: microsoft.graph

Atualizar a função de um conversationMember em uma equipe ou canal.Update the role of a conversationMember in a team or channel.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission Type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)Delegated (work or school account) No Teams: TeamMember. ReadWrite. AllIn teams: TeamMember.ReadWrite.All
Em canais: ChannelMember. ReadWrite. AllIn channels: ChannelMember.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporteNot supported
AplicativoApplication No Teams: TeamMember. ReadWrite. AllIn teams: TeamMember.ReadWrite.All
Em canais: ChannelMember. ReadWrite. AllIn channels: ChannelMember.ReadWrite.All

Solicitação HTTPHTTP request

PATCH /teams/{id}/channels/{id}/members/{id}

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça os valores para os campos relevantes a serem atualizados.In the request body, supply the values for the relevant fields to update. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade.Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.For best performance, don't include existing values that haven't changed.

PropriedadeProperty TipoType DescriçãoDescription
funçõesroles coleção de cadeias de caracteresstring collection As funções desse usuário.The roles for that user. Deve ser "proprietário" ou vazio.Must be "owner" or empty. Os usuários convidados devem sempre ter a função "convidado" e não podem ser alterados.Guest users must always have role "guest" and cannot change.

RespostaResponse

Se bem-sucedido, este método retornará um código de resposta 200 OK e um objeto conversationMember no corpo da resposta.If successful, this method returns a 200 OK response code and a conversationMember object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

PATCH https://graph.microsoft.com/V1.0/teams/{id}/channels/{id}/members/{id}
content-type: application/json
content-length: 26

{
  "@odata.type":"#microsoft.graph.aadUserConversationMember",
  "roles": ["owner"]
}

RespostaResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 475

{
  "@odata.context": "https://graph.microsoft.com/V1.0/$metadata#teams('ece6f0a1-7ca4-498b-be79-edf6c8fc4d82')/channels('19%3A56eb04e133944cf69e603c5dac2d292e%40thread.skype')/members/microsoft.graph.aadUserConversationMember/$entity",
  "@odata.type": "#microsoft.graph.aadUserConversationMember",
  "id": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
  "roles": ["owner"],
  "displayName": "John Doe",
  "userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
  "email": null
}