Atualizar chatMessage

Artigo
07/18/2022
12 minutos para o fim da leitura

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 de versão.

Atualize um objeto chatMessage . Com exceção da propriedade policyViolation , todas as propriedades de um chatMessage podem ser atualizadas em cenários de permissões delegadas. Somente a propriedade policyViolation de um chatMessage pode ser atualizada em cenários de permissões de aplicativo.

Observação: esta API tem requisitos de licenciamento e pagamento. Ele dá suporte model=A ao parâmetro de consulta. Se nenhum modelo for especificado, o modo de avaliação será usado.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegada (conta corporativa ou de estudante)	Chat.ReadWrite
Delegada (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Chat.UpdatePolicyViolation.All para uma mensagem de chat. ChannelMessage.UpdatePolicyViolation.All para uma mensagem de canal.

Solicitação HTTP

PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}
PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}/replies/{reply-id}
PATCH /chats/{chatThread-id}/messages/{message-id}

Parâmetros de consulta opcionais

Você pode usar model o parâmetro de consulta, que dá suporte apenas ao valor A, conforme mostrado nos exemplos a seguir.

PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}?model=A
PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}/replies/{reply-id}?model=A
PATCH /chats/{chatThread-id}/messages/{message-id}?model=A

Se nenhum model for especificado, modo de avaliação será usado.

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

Para aplicativos que usam permissões delegadas: no corpo da solicitação, forneça uma representação JSON de um objeto chatMessage , especificando as propriedades que precisam ser alteradas.

Para aplicativos que usam permissões de aplicativo: no corpo da solicitação, forneça uma representação JSON de um objeto chatMessage , especificando apenas a propriedade policyViolation .

Corpo da resposta

Para aplicativos que usam permissões delegadas: se for bem-sucedido, este método retornará uma 204 NoContent resposta.

Para aplicativos que usam permissões de aplicativo: se for bem-sucedido, este método retornará uma 200 OK resposta.

Exemplo para atualizar policyViolation usando permissões de aplicativo

Solicitação

A seguir está um exemplo da solicitação para atualizar a propriedade policyViolation em uma mensagem de canal do Microsoft Teams usando permissões de aplicativo.

PATCH https://graph.microsoft.com/beta/teams/e1234567-e123-4276-55555-6232b0e3a89a/channels/a7654321-e321-0000-0000-123b0e3a00a/messages/19%3Aa21b0b0c05194ebc9e30000000000f61%40thread.skype
Content-Type: application/json

{
  "policyViolation": {
    "policyTip": {
      "generalText" : "This item has been blocked by the administrator.",
      "complianceUrl" : "https://contoso.com/dlp-policy-page",
      "matchedConditionDescriptions" : ["Credit Card Number"]
    },
    "verdictDetails" : "AllowOverrideWithoutJustification,AllowFalsePositiveOverride",
    "dlpAction" : "BlockAccess"
  }
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var chatMessage = new ChatMessage
{
    PolicyViolation = new ChatMessagePolicyViolation
    {
        PolicyTip = new ChatMessagePolicyViolationPolicyTip
        {
            GeneralText = "This item has been blocked by the administrator.",
            ComplianceUrl = "https://contoso.com/dlp-policy-page",
            MatchedConditionDescriptions = new List<String>()
            {
                "Credit Card Number"
            }
        },
        VerdictDetails = ChatMessagePolicyViolationVerdictDetailsTypes.AllowFalsePositiveOverride | ChatMessagePolicyViolationVerdictDetailsTypes.AllowOverrideWithoutJustification,
        DlpAction = ChatMessagePolicyViolationDlpActionTypes.BlockAccess
    }
};

await graphClient.Teams["{team-id}"].Channels["{channel-id}"].Messages["{chatMessage-id}"]
    .Request()
    .UpdateAsync(chatMessage);

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não dão suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.