tipo de recurso de mensaje

Espacio de nombres: microsoft.graph

Un mensaje en un mailFolder.

El número máximo total de destinatarios incluidos en las propiedades toRecipients, ccRecipients y bccRecipients, para un único mensaje de correo electrónico enviado desde un buzón de Exchange Online es de 500. Para obtener más información, consulte los límites de envío.

Este recurso admite:

  • La adición de sus propios datos como encabezados de mensaje personalizados de Internet. La adición de encabezados personalizados solo al crear un mensaje y otorgarles un nombre que comience por "x-". Una vez que se ha enviado el mensaje, no se pueden modificar los encabezados. Para obtener los encabezados de un mensaje, aplique el $select parámetro consulta en una operación obtener mensaje.
  • La adición de sus propios datos, como las propiedades personalizadas, como extensiones.
  • La suscripción a notificaciones de cambios.
  • El uso de una consulta delta para realizar un seguimiento de los aumentos incrementales, las eliminaciones y las actualizaciones proporcionando una función delta.

Métodos

Método Tipo de valor devuelto Descripción
Enumerar mensajes Colección message Obtiene todos los mensajes del buzón del usuario que ha iniciado sesión (incluidas las carpetas Elementos eliminados y Otros correos).
Crear mensaje mensaje Crea un borrador de un mensaje nuevo.
Obtener mensaje mensaje Lee las propiedades y las relaciones del objeto de mensaje.
Actualizar mensaje Actualiza el objeto de mensaje.
Eliminar Ninguno Elimina el objeto de mensaje.
copy Mensaje Copia un mensaje a una carpeta.
createForward Mensaje Crea un borrador del mensaje que de reenvío. Después puede actualizar o enviar el borrador.
createReply Mensaje Crea un borrador del mensaje de respuesta. Después puede actualizar o enviar el borrador.
createReplyAll Mensaje Crea un borrador del mensaje de respuesta a todos. Después puede actualizar o enviar el borrador.
delta Colección message Obtenga un conjunto de mensajes que se hayan agregado, eliminado o actualizado en una carpeta determinada.
forward Ninguno Reenvía un mensaje. El mensaje se guarda en la carpeta Elementos enviados.
move Mensaje Mueve un mensaje a una carpeta. Se crea una nueva copia del mensaje en la carpeta de destino.
reply Ninguno Responde al remitente de un mensaje. El mensaje se guarda en la carpeta Elementos enviados.
replyAll Ninguno Responde a todos los remitentes de un mensaje. El mensaje se guarda en la carpeta Elementos enviados.
send Ninguno Envía un borrador de mensaje creado anteriormente. El mensaje se guarda en la carpeta Elementos enviados.
Datos adjuntos
Enumerar datos adjuntos Colección attachment Obtiene todos los datos adjuntos en un mensaje.
Agregar datos adjuntos Dato adjunto Agrega un dato adjunto nuevo a un mensaje publicándolo en la colección de datos adjuntos.
Extensiones abiertas
Crear extensión abierta openTypeExtension Crea una extensión abierta y agrega propiedades personalizadas en una instancia nueva o existente de un recurso.
Obtener extensión abierta Colección openTypeExtension Obtenga un objeto u objetos de extensión abierta identificados por nombre o por nombre completo.
Extensiones de esquema
Agregar valores de extensión de esquema Cree una definición de extensión de esquema y, después, úsela para agregar datos escritos personalizados a un recurso.
Propiedades extendidas
Crear propiedad extendida de valor único mensaje Crea una o más propiedades extendidas de valor único en un mensaje nuevo o existente.
Obtener mensaje con propiedad extendida de valor único mensaje Obtiene mensajes que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.
Crear propiedad extendida de varios valores mensaje Crea una o más propiedades extendidas de varios valores en un mensaje nuevo o existente.
Obtener mensaje con propiedad extendida de varios valores mensaje Obtiene un mensaje que contiene una propiedad extendida de varios valores mediante el uso de $expand.

Propiedades

Propiedad Tipo Descripción
bccRecipients Colección recipient Los destinatarios Cco: del mensaje.
body itemBody El cuerpo del mensaje. Puede mostrarse en formato de texto o HTML. Conozca más sobre HTML seguro en el cuerpo del mensaje.
bodyPreview String Los primeros 255 caracteres del cuerpo del mensaje. Se muestran en formato de texto.
categories Colección string Las categorías asociadas al mensaje.
ccRecipients Colección recipient Los destinatarios Cc: del mensaje.
changeKey String La versión del mensaje.
conversationId String Identificador de la conversación a la que pertenece el correo electrónico.
conversationIndex Edm.Binary Indica la posición del mensaje en la conversación.
createdDateTime DateTimeOffset La fecha y la hora de creación del mensaje.

La información sobre la fecha y la hora utiliza el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z.
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 desde el que se envía el mensaje. En la mayoría de los casos, este valor es igual que el de la propiedad sender, excepto en escenarios de uso compartido o delegación. El valor debe corresponder al buzón real usado. Conozca más sobre el establecimiento de las propiedades from y sender de un mensaje.
hasAttachments Booleano Indica si el mensaje tiene datos adjuntos. Esta propiedad no incluye datos adjuntos insertados, por lo que si un mensaje contiene solo datos adjuntos insertados, esta propiedad es igual a false. Para comprobar si hay datos adjuntos insertados, analice la propiedad body en busca de un atributo src, como <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.
id String Identificador único del mensaje (tenga en cuenta que este valor puede cambiar si se mueve o se altera un mensaje)
importance importance La importancia del mensaje. Los valores posibles son low, normal, y high.
inferenceClassification inferenceClassificationType La clasificación del mensaje para el usuario, según relevancia inferida, importancia o según una invalidación explícita. Los valores posibles son: focused o other.
internetMessageHeaders Colección internetMessageHeader Una colección de encabezados de mensaje definidos por RFC5322. El conjunto incluye encabezados de mensaje que indican la ruta de red realizada por un mensaje desde el remitente hasta el destinatario. También puede contener los encabezados de mensaje personalizados que contienen datos de la aplicación para el mensaje.

Se devuelve sólo al aplicar una $select opción de consulta. Sólo lectura.
internetMessageId String El identificador del mensaje en el formato especificado por RFC2822.
isDeliveryReceiptRequested Booleano Indica si se solicita confirmación de lectura para el mensaje.
isDraft Boolean Indica si el mensaje es un borrador. Un mensaje es un borrador si no se ha enviado todavía.
isRead Booleano Indica si se ha leído el mensaje.
isReadReceiptRequested Booleano Indica si se solicita confirmación de lectura para el mensaje.
lastModifiedDateTime DateTimeOffset La fecha y la hora de la última modificación del mensaje.

La información sobre la fecha y la hora utiliza el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z.
parentFolderId String El identificador único para el mailFolder principal del mensaje.
receivedDateTime DateTimeOffset La fecha y la hora en las que se recibió el mensaje.

La información sobre la fecha y la hora utiliza el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z.
replyTo Colección recipient Las direcciones de correo electrónico que se utilizan al responder.
sender recipient La cuenta que se utiliza realmente para generar el mensaje. En la mayoría de los casos, este valor es el mismo que el de la propiedad from. Puede establecer esta propiedad como un valor distinto al enviar un mensaje desde un buzón compartido, para un calendario compartido o como delegado. En cualquier caso, el valor debe corresponder al buzón real usado. Conozca más sobre el establecimiento de las propiedades from y sender de un mensaje.
sentDateTime DateTimeOffset La fecha y la hora de envío del mensaje.

La información sobre la fecha y la hora utiliza el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z.
subject String El asunto del mensaje.
toRecipients Colección recipient Los destinatarios Para: del mensaje.
uniqueBody itemBody La parte del cuerpo del mensaje que es única del mensaje actual. El elemento uniqueBody no se devuelve de manera predeterminada, pero puede recuperarse para cualquier mensaje con la consulta ?$select=uniqueBody. Puede mostrarse en formato de texto o HTML.
webLink String La dirección URL para abrir el mensaje en Outlook en la Web.

Puede agregar un argumento ispopout al final de la dirección URL para cambiar el modo en que se muestra el mensaje. Si ispopout no está presente o si se establece en 1, el mensaje se mostrará en una ventana emergente. Si ispopout se establece en 0, el explorador mostrará el mensaje en el panel de revisión en Outlook en la Web.

Si ha iniciado sesión en su buzón de correo a través de Outlook en la Web, el mensaje se abrirá en el explorador. Se le pedirá que se identifique si no ha iniciado la sesión con el explorador.

No se puede tener acceso a esta dirección URL desde un iFrame.

Relaciones

Relación Tipo Descripción
attachments Colección attachment Los datos adjuntos fileAttachment y itemAttachment del mensaje.
extensions Colección Extension La colección de extensiones abiertas definidas para el mensaje. Admite un valor NULL.
multiValueExtendedProperties Colección multiValueLegacyExtendedProperty La colección de propiedades extendidas de varios valores definidas para el mensaje. Admite valores NULL.
singleValueExtendedProperties Colección singleValueLegacyExtendedProperty La colección de propiedades extendidas de valor único definidas para el mensaje. Admite un valor NULL.

Representación JSON

Aquí tiene una representación JSON del recurso

{
  "bccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "changeKey": "string",
  "conversationId": "string",
  "conversationIndex": "String (binary)",
  "createdDateTime": "String (timestamp)",
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "from": {"@odata.type": "microsoft.graph.recipient"},
  "hasAttachments": true,
  "id": "string (identifier)",
  "importance": "String",
  "inferenceClassification": "String",
  "internetMessageHeaders": [{"@odata.type": "microsoft.graph.internetMessageHeader"}],
  "internetMessageId": "String",
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "String (timestamp)",
  "parentFolderId": "string",
  "receivedDateTime": "String (timestamp)",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "String (timestamp)",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "webLink": "string",

  "attachments": [{"@odata.type": "microsoft.graph.attachment"}],
  "extensions": [{"@odata.type": "microsoft.graph.extension"}],
  "multiValueExtendedProperties": [{"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"}],
  "singleValueExtendedProperties": [{"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"}]
}

Vea también