Compartir a través de


Actualizar mensaje

Espacio de nombres: microsoft.graph

Actualice las propiedades de un objeto de mensaje.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Mail.ReadWrite
Delegado (cuenta personal de Microsoft) Mail.ReadWrite
Aplicación Mail.ReadWrite

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

Encabezados de solicitud

Nombre Tipo Descripción
Authorization string {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type string Naturaleza de los datos en el cuerpo de una entidad. Obligatorio.

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos relevantes que deben actualizarse. Las propiedades existentes que no se incluyan en el cuerpo de la solicitud mantendrán los valores anteriores o se recalcularán según los cambios efectuados en otros valores de propiedad. Para obtener el mejor rendimiento no debe incluir valores existentes que no hayan cambiado. Se pueden actualizar las siguientes propiedades.

Propiedad Tipo Descripción
bccRecipients Recipient Los destinatarios CCO del mensaje.
body ItemBody El cuerpo del mensaje. Solo se puede actualizar si isDraft = true.
categorías Colección string Las categorías asociadas al mensaje.
ccRecipients Colección Recipient Los destinatarios CC del mensaje.
flag followupFlag Valor de marca que indica el estado, la fecha de inicio, la fecha de vencimiento o la fecha de finalización del mensaje.
from Recipient El propietario del buzón y el remitente del mensaje. El valor debe corresponder al buzón real usado.
importance String La importancia del mensaje. Los valores posibles son: Low, Normal, High.
inferenceClassification String Clasificación del mensaje para el usuario, según la relevancia o importancia inferida, o bien según un reemplazo explícito. Los valores posibles son: focused o other.
internetMessageId String El identificador del mensaje en el formato especificado por RFC2822. Solo se puede actualizar si isDraft = true.
isDeliveryReceiptRequested Booleano Indica si se solicita confirmación de lectura para el mensaje.
isRead Booleano Indica si se ha leído el mensaje.
isReadReceiptRequested Booleano Indica si se solicita confirmación de lectura para el mensaje.
multiValueExtendedProperties Colección multiValueLegacyExtendedProperty La colección de propiedades extendidas de varios valores definidas para el mensaje. Admite un valor NULL.
replyTo Colección Recipient Las direcciones de correo electrónico que se utilizan al responder. Solo se puede actualizar si isDraft = true.
sender Recipient La cuenta que se utiliza realmente para generar el mensaje. Se puede actualizar al enviar un mensaje desde un buzón compartido o enviar un mensaje como delegado. En cualquier caso, el valor debe corresponder al buzón real usado.
singleValueExtendedProperties Colección singleValueLegacyExtendedProperty La colección de propiedades extendidas de valor único definidas para el mensaje. Admite valores NULL.
subject String El asunto del mensaje. Solo se puede actualizar si isDraft = true.
toRecipients Colección Recipient Los destinatarios Para del mensaje.

Dado que el recurso message admite extensiones, puede utilizar la operación PATCH para agregar, actualizar o eliminar sus propios datos específicos de la aplicación en las propiedades personalizadas de una extensión en una instancia message existente.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y el objeto message actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

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

En el ejemplo siguiente se muestra la respuesta. Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.

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