Compartilhar via


Atualizar mensagem

Namespace: microsoft.graph

Atualizar as propriedades de um objeto mensagem.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Uma das seguintes permissões é necessá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)
Delegado (conta corporativa ou de estudante) Mail.ReadWrite
Delegado (conta pessoal da Microsoft) Mail.ReadWrite
Aplicativo Mail.ReadWrite

Solicitação HTTP

PATCH /me/messages/{id}
PATCH /users/{id | userPrincipalName}/messages/{id}
PATCH /me/mailFolders/{id}/messages/{id}
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}

Cabeçalhos de solicitação

Nome Tipo Descrição
Autorização string {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type string Natureza dos dados no corpo de uma entidade. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. 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. Para obter um melhor desempenho, não inclua valores existentes que não foram alterados. As propriedades a seguir podem ser atualizadas.

Propriedade Tipo Descrição
bccRecipients Destinatário Os destinatários Cco da mensagem.
corpo ItemBody O corpo da mensagem. Atualizável apenas se IsDraft = true.
Categorias String collection As categorias associadas à mensagem.
ccRecipients Coleção Recipient Os destinatários Cc da mensagem.
sinalizador followupFlag O valor do sinalizador que indica o status, a data de início, a data de conclusão ou a data de finalização da mensagem.
from Destinatário O proprietário da caixa de correio e o remetente da mensagem. Devem corresponder à caixa de correio real que foi usada.
importância String A importância da mensagem. Os valores possíveis são: Low, Normal, High.
inferenceClassification String A classificação da mensagem para o usuário, com base na relevância ou importância deduzida ou em uma substituição explícita. Os valores possíveis são: focused ou other.
internetMessageId String A ID da mensagem no formato especificado por RFC2822. Atualizável apenas se IsDraft = true.
isDeliveryReceiptRequested Boolean Indica se uma confirmação de leitura foi solicitada para a mensagem.
isRead Boolean Indica se a mensagem foi lida.
isReadReceiptRequested Boolean Indica se uma confirmação de leitura foi solicitada para a mensagem.
multiValueExtendedProperties Coleção multiValueLegacyExtendedProperty A coleção de propriedades estendidas de vários valores definidas para a mensagem. Anulável.
replyTo Coleção Recipient Os endereços de email a serem usados ao responder. Atualizável apenas se IsDraft = true.
remetente Destinatário A conta que é realmente usada para gerar a mensagem. Atualizável ao enviar uma mensagem de uma caixa de correio compartilhada, ou enviar uma mensagem como um delegado. De qualquer forma, o valor deve corresponder à caixa de correio real que foi usada.
singleValueExtendedProperties Coleção singleValueLegacyExtendedProperty A coleção de propriedades estendidas de valor único definidas para a mensagem. Anulável.
Assunto String O assunto da mensagem. Atualizável apenas se IsDraft = true.
toRecipients Coleção Recipient Os destinatários Para da mensagem.

Como o recurso message dá suporte a extensions, você pode usar a operação PATCH para adicionar, atualizar ou excluir seus próprios dados específicos do aplicativo nas propriedades personalizadas de uma extensão em uma instância de message existente.

Resposta

Se bem-sucedido, este método retorna um código de resposta 200 OK e o objeto message atualizado no corpo da resposta.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/me/messages/{id}
Content-type: application/json

{
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "inferenceClassification": "other"
}
Resposta

O exemplo a seguir mostra a resposta. Observação: O objeto de resposta exibido aqui pode ser encurtado para legibilidade.

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

{
  "receivedDateTime": "datetime-value",
  "sentDateTime": "datetime-value",
  "hasAttachments": true,
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "bodyPreview": "bodyPreview-value",
  "inferenceClassification": "other"
}