Atualizar conversationMemberUpdate conversationMember

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível no v 1.0, use o seletor de versão .To determine whether an API is available in v1.0, use the Version selector.

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

Observação

Em canais, essa operação só é suportada em canais com um channelMembershipType de private .On channels, this operation is only supported on channels with a channelMembershipType of private. Chamadas com qualquer outro channelMembershipType retornará uma 400 Bad Request resposta.Calls with any other channelMembershipType will return a 400 Bad Request response.

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)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) No Teams: TeamMember. ReadWrite. AllIn teams: TeamMember.ReadWrite.All
Em canais: ChannelMember. ReadWrite. All, Group. ReadWrite. All, Directory. ReadWrite. AllIn channels: ChannelMember.ReadWrite.All, Group.ReadWrite.All, Directory.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. All, Group. ReadWrite. All, Directory. ReadWrite. AllIn channels: ChannelMember.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All

Solicitação HTTPHTTP request

PATCH /teams/{id}/members/{id}
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/beta/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/beta/$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
}