userTeamwork: deleteTargetedMessage

Namespace: microsoft.graph

Exclua uma mensagem direcionada específica de um contexto de canal. Os administradores do Teams podem usar essa API para remover mensagens direcionadas, fornecendo a ID da mensagem, a ID da equipe e a ID do canal.

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

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ❌ ❌ ❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Trabalho em equipeTargetedMessage.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST /users/{user-id | userPrincipalName}/teamwork/deleteTargetedMessage

Cabeçalhos de solicitação

Nome Descrição
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, forneça uma representação JSON dos parâmetros.

A tabela a seguir lista os parâmetros necessários quando você chama essa ação.

Parâmetro Tipo Descrição
channelId Cadeia de caracteres O identificador exclusivo do canal para o qual a mensagem de destino foi enviada. Obrigatório.
messageId Cadeia de caracteres O identificador exclusivo da mensagem de destino a ser excluída. Essa ID é exclusiva no contexto do canal e do usuário especificados. Obrigatório.
teamId Cadeia de caracteres O identificador exclusivo da equipe que contém o canal para o qual a mensagem de destino foi enviada. Obrigatório.

Resposta

Se tiver êxito, esta ação retornará um código de resposta 204 No Content.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/users/f47b5f54-6968-4706-a522-31e842b12345/teamwork/deleteTargetedMessage
Content-Type: application/json

{
  "teamId": "9dda0ae1-e007-4a1d-81ec-2cf4b1274610",
  "channelId": "19:eeaa4e946d674c4f8d4dded613780f45@thread.v2",
  "messageId": "1580849738240"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Last updated on