Atualizar mensagem

Namespace: microsoft.graph

Atualizar as propriedades de um objeto mensagem.

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)
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.
Content-Type	string	Natureza dos dados no corpo de uma entidade. Obrigatório.

Corpo da solicitação

No corpo de solicitação, forneça os valores para os campos relevantes que devem ser atualizados. As propriedades existentes que não estão incluídas no corpo da solicitação manterão seus valores anteriores ou serão recalculadas com base nas mudanças de outros valores de propriedade. Para obter o melhor desempenho, você não deve incluir valores existentes que não tenham sido alterados. As seguintes propriedades podem ser atualizadas.

Propriedade	Tipo	Descrição
bccRecipients	Destinatário	Os destinatários Cco da mensagem.
corpo	ItemBody	O corpo da mensagem. Atualizável somente 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 inferida, ou em uma substituição explícita. Os valores possíveis são: focused ou other.
internetMessageId	String	O 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 para usar ao responder. Atualizável somente 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 somente 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

Este é um exemplo da solicitação.

HTTP

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

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

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var message = new Message
{
    Subject = "subject-value",
    Body = new ItemBody
    {
        ContentType = BodyType.Text,
        Content = "content-value"
    },
    InferenceClassification = InferenceClassificationType.Other
};

await graphClient.Me.Messages["{message-id}"]
    .Request()
    .UpdateAsync(message);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const message = {
  subject: 'subject-value',
  body: {
    contentType: '',
    content: 'content-value'
  },
  inferenceClassification: 'other'
};

await client.api('/me/messages/{id}')
    .update(message);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

Message message = new Message();
message.subject = "subject-value";
ItemBody body = new ItemBody();
body.contentType = BodyType.TEXT;
body.content = "content-value";
message.body = body;
message.inferenceClassification = InferenceClassificationType.OTHER;

graphClient.me().messages("{id}")
    .buildRequest()
    .patch(message);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewMessage()
subject := "subject-value"
requestBody.SetSubject(&subject)
body := msgraphsdk.NewItemBody()
requestBody.SetBody(body)
contentType := ""
body.SetContentType(&contentType)
content := "content-value"
body.SetContent(&content)
inferenceClassification := "other"
requestBody.SetInferenceClassification(&inferenceClassification)
messageId := "message-id"
graphClient.Me().MessagesById(&messageId).Patch(requestBody)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

PowerShell

Import-Module Microsoft.Graph.Mail

$params = @{
    Subject = "subject-value"
    Body = @{
        ContentType = ""
        Content = "content-value"
    }
    InferenceClassification = "other"
}

# A UPN can also be used as -UserId.
Update-MgUserMessage -UserId $userId -MessageId $messageId -BodyParameter $params

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

Resposta

Aqui está um exemplo da resposta. Observação: o objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.

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"
}

Confira também

• Adicionar dados personalizados a recursos usando extensões
• Adicionar dados personalizados aos usuários usando extensões abertas (visualização)