tipo de recurso de mensajemessage resource type

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Un mensaje en un mailFolder.A message in a 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 500.The maximum total number of recipients included in the toRecipients , ccRecipients , and bccRecipients properties for a single email message sent from an Exchange Online mailbox is 500. Para más información, consulte Límites de envíos.For more information, see sending limits.

Este recurso admite:This resource supports:

  • La adición de sus propios datos como encabezados de mensaje personalizados de Internet.Adding your own data as custom Internet message headers. La adición de encabezados personalizados solo al crear un mensaje y otorgarles un nombre que comience por "x-".Add custom headers only when creating a message, and name them starting with "x-". Una vez que se ha enviado el mensaje, no se pueden modificar los encabezados.Once the message has been sent, you cannot modify the headers. Para obtener los encabezados de un mensaje, aplique el $select parámetro consulta en una operación obtener mensaje.To get the headers of a message, apply the $select query parameter in a get message operation.
  • La adición de sus propios datos, como las propiedades personalizadas, como extensiones.Adding your own data as custom properties as extensions.
  • La suscripción a notificaciones de cambios.Subscribing to change notifications.
  • El uso de una consulta delta para realizar un seguimiento de los aumentos incrementales, las eliminaciones y las actualizaciones proporcionando una función delta.Using delta query to track incremental additions, deletions, and updates, by providing a delta function.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Enumerar mensajesList messages Colección messagemessage collection Obtiene todos los mensajes del buzón del usuario que ha iniciado sesión (incluidas las carpetas Elementos eliminados y Otros correos).Get all the messages in the signed-in user's mailbox (including the Deleted Items and Clutter folders).
Crear mensajeCreate message mensajemessage Crea un borrador de un mensaje nuevo.Create a draft of a new message.
Obtener mensajeGet message mensajemessage Lee las propiedades y las relaciones del objeto de mensaje.Read properties and relationships of message object.
ActualizarUpdate mensajemessage Actualiza el objeto de mensaje.Update message object.
EliminarDelete NingunoNone Elimina el objeto de mensaje.Delete message object.
copycopy MensajeMessage Copia un mensaje a una carpeta.Copy a message to a folder.
createForwardcreateForward MensajeMessage Crea un borrador del mensaje que de reenvío. Después puede actualizar o enviar el borrador.Create a draft of the Forward message. You can then update or send the draft.
createReplycreateReply MensajeMessage Crea un borrador del mensaje de respuesta. Después puede actualizar o enviar el borrador.Create a draft of the Reply message. You can then update or send the draft.
createReplyAllcreateReplyAll MensajeMessage Crea un borrador del mensaje de respuesta a todos. Después puede actualizar o enviar el borrador.Create a draft of the Reply All message. You can then update or send the draft.
deltadelta Colección messagemessage collection Obtenga un conjunto de mensajes que se hayan agregado, eliminado o actualizado en una carpeta determinada.Get a set of messages that have been added, deleted, or updated in a specified folder.
forwardforward NingunoNone Reenvía un mensaje. El mensaje se guarda en la carpeta Elementos enviados.Forward a message. The message is then saved in the Sent Items folder.
movemove MensajeMessage Mueve un mensaje a una carpeta. Se crea una nueva copia del mensaje en la carpeta de destino.Move the message to a folder. This creates a new copy of the message in the destination folder.
replyreply NingunoNone Responde al remitente de un mensaje. El mensaje se guarda en la carpeta Elementos enviados.Reply to the sender of a message. The message is then saved in the Sent Items folder.
replyAllreplyAll NingunoNone Responde a todos los remitentes de un mensaje. El mensaje se guarda en la carpeta Elementos enviados.Reply to all recipients of a message. The message is then saved in the Sent Items folder.
sendsend NingunoNone Envía un borrador de mensaje creado anteriormente. El mensaje se guarda en la carpeta Elementos enviados.Sends a previously created message draft. The message is then saved in the Sent Items folder.
Datos adjuntosAttachments
Enumerar datos adjuntosList attachments Colección attachmentAttachment collection Obtiene todos los datos adjuntos en un mensaje.Gets all attachments on a message.
Agregar datos adjuntosAdd attachment Dato adjuntoAttachment Agrega un dato adjunto nuevo a un mensaje publicándolo en la colección de datos adjuntos.Add a new attachment to a message by posting to the attachments collection.
Extensiones abiertasOpen extensions
Crear extensión abiertaCreate open extension openTypeExtensionopenTypeExtension Crea una extensión abierta y agrega propiedades personalizadas en una instancia nueva o existente de un recurso.Create an open extension and add custom properties in a new or existing instance of a resource.
Obtener extensión abiertaGet open extension Colección openTypeExtensionopenTypeExtension collection Obtenga un objeto u objetos de extensión abierta identificados por nombre o por nombre completo.Get an open extension object or objects identified by name or fully qualified name.
Extensiones de esquemaSchema extensions
Agregar valores de extensión de esquemaAdd schema extension values Cree una definición de extensión de esquema y, después, úsela para agregar datos escritos personalizados a un recurso.Create a schema extension definition and then use it to add custom typed data to a resource.
Propiedades extendidasExtended properties
Crear propiedad extendida de valor únicoCreate single-value extended property mensajemessage Crea una o más propiedades extendidas de valor único en un mensaje nuevo o existente.Create one or more single-value extended properties in a new or existing message.
Obtener mensaje con propiedad extendida de valor únicoGet message with single-value extended property mensajemessage Obtiene mensajes que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.Get messages that contain a single-value extended property by using $expand or $filter.
Crear propiedad extendida de varios valoresCreate multi-value extended property mensajemessage Crea una o más propiedades extendidas de varios valores en un mensaje nuevo o existente.Create one or more multi-value extended properties in a new or existing message.
Obtener mensaje con propiedad extendida de varios valoresGet message with multi-value extended property mensajemessage Obtiene un mensaje que contiene una propiedad extendida de varios valores mediante el uso de $expand.Get a message that contains a multi-value extended property by using $expand.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
bccRecipientsbccRecipients Colección recipientrecipient collection Los destinatarios Cco: del mensaje.The Bcc: recipients for the message.
bodybody itemBodyitemBody El cuerpo del mensaje.The body of the message. Puede mostrarse en formato de texto o HTML.It can be in HTML or text format. Conozca más sobre HTML seguro en el cuerpo del mensaje.Find out about safe HTML in a message body.
bodyPreviewbodyPreview StringString Los primeros 255 caracteres del cuerpo del mensaje. Se muestran en formato de texto.The first 255 characters of the message body. It is in text format.
categoriescategories Colección stringString collection Las categorías asociadas al mensaje.The categories associated with the message.
ccRecipientsccRecipients Colección recipientrecipient collection Los destinatarios Cc: del mensaje.The Cc: recipients for the message.
changeKeychangeKey StringString La versión del mensaje.The version of the message.
conversationIdconversationId StringString Identificador de la conversación a la que pertenece el correo electrónico.The ID of the conversation the email belongs to.
conversationIndexconversationIndex Edm.BinaryEdm.Binary Indica la posición del mensaje en la conversación.Indicates the position of the message within the conversation.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset La fecha y la hora de creación del mensaje.The date and time the message was created.
flagflag followupFlagfollowupFlag Valor de marca que indica el estado, la fecha de inicio, la fecha de vencimiento o la fecha de finalización del mensaje.The flag value that indicates the status, start date, due date, or completion date for the message.
fromfrom recipientrecipient El propietario del buzón desde el que se envía el mensaje.The owner of the mailbox from which the message is sent. 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.In most cases, this value is the same as the sender property, except for sharing or delegation scenarios. El valor debe corresponder al buzón real usado.The value must correspond to the actual mailbox used. Conozca más sobre el establecimiento de las propiedades from y sender de un mensaje.Find out more about setting the from and sender properties of a message.
hasAttachmentshasAttachments BooleanoBoolean 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">.Indicates whether the message has attachments. This property doesn't include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.
idid StringString Identificador único del mensaje (tenga en cuenta que este valor puede cambiar si se mueve o se altera un mensaje)Unique identifier for the message (note that this value may change if a message is moved or altered)
importanceimportance importanceimportance La importancia del mensaje: Low, Normal y High.The importance of the message: Low, Normal, High.
inferenceClassificationinferenceClassification inferenceClassificationTypeinferenceClassificationType La clasificación del mensaje para el usuario, según relevancia inferida, importancia o según una invalidación explícita.The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. Los valores posibles son: focused o other.The possible values are: focused or other.
internetMessageHeadersinternetMessageHeaders Colección internetMessageHeaderinternetMessageHeader collection Una colección de encabezados de mensaje definidos por RFC5322.A collection of message headers defined by RFC5322. El conjunto incluye encabezados de mensaje que indican la ruta de red realizada por un mensaje desde el remitente hasta el destinatario.The set includes message headers indicating the network path taken by a message from the sender to the recipient. También puede contener los encabezados de mensaje personalizados que contienen datos de la aplicación para el mensaje.It can also contain custom message headers that hold app data for the message.

Se devuelve solo al aplicar una opción de consulta $select.Returned only on applying a $select query option. Solo lectura.Read-only.
internetMessageIdinternetMessageId StringString El identificador del mensaje en el formato especificado por RFC2822.The message ID in the format specified by RFC2822.
isDeliveryReceiptRequestedisDeliveryReceiptRequested BooleanoBoolean Indica si se solicita confirmación de lectura para el mensaje.Indicates whether a read receipt is requested for the message.
isDraftisDraft BooleanBoolean Indica si el mensaje es un borrador. Un mensaje es un borrador si no se ha enviado todavía.Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
isReadisRead BooleanoBoolean Indica si se ha leído el mensaje.Indicates whether the message has been read.
isReadReceiptRequestedisReadReceiptRequested BooleanoBoolean Indica si se solicita confirmación de lectura para el mensaje.Indicates whether a read receipt is requested for the message.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset La fecha y la hora de la última modificación del mensaje.The date and time the message was last changed.
parentFolderIdparentFolderId StringString El identificador único para el mailFolder principal del mensaje.The unique identifier for the message's parent mailFolder.
receivedDateTimereceivedDateTime DateTimeOffsetDateTimeOffset La fecha y la hora en las que se recibió el mensaje.The date and time the message was received.
replyToreplyTo Colección recipientrecipient collection Las direcciones de correo electrónico que se utilizan al responder.The email addresses to use when replying.
sendersender recipientrecipient La cuenta que se utiliza realmente para generar el mensaje.The account that is actually used to generate the message. En la mayoría de los casos, este valor es el mismo que el de la propiedad from .In most cases, this value is the same as the from property. Puede establecer esta propiedad como un valor distinto al enviar un mensaje desde un buzón compartido, para un calendario compartido o como delegado.You can set this property to a different value when sending a message from a shared mailbox, for a shared calendar, or as a delegate. En cualquier caso, el valor debe corresponder al buzón real usado.In any case, the value must correspond to the actual mailbox used. Conozca más sobre el establecimiento de las propiedades from y sender de un mensaje.Find out more about setting the from and sender properties of a message.
sentDateTimesentDateTime DateTimeOffsetDateTimeOffset La fecha y la hora de envío del mensaje.The date and time the message was sent.
subjectsubject StringString El asunto del mensaje.The subject of the message.
toRecipientstoRecipients Colección recipientrecipient collection Los destinatarios Para: del mensaje.The To: recipients for the message.
uniqueBodyuniqueBody itemBodyitemBody 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.The part of the body of the message that is unique to the current message. uniqueBody is not returned by default but can be retrieved for a given message by use of the ?$select=uniqueBody query. It can be in HTML or text format.
webLinkwebLink StringString La dirección URL para abrir el mensaje en Outlook en la Web.The URL to open the message in Outlook on the 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.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser will show the message in the Outlook on the web review pane.

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.The message will open in the browser if you are logged in to your mailbox via Outlook on the web. You will be prompted to login if you are not already logged in with the browser.

No se puede tener acceso a esta dirección URL desde un iFrame.This URL cannot be accessed from within an iFrame.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
attachmentsattachments Colección attachmentattachment collection Los datos adjuntos fileAttachment y itemAttachment del mensaje.The fileAttachment and itemAttachment attachments for the message.
extensionsextensions Colección extensionextension collection La colección de extensiones abiertas definidas para el mensaje.The collection of open extensions defined for the message. Admite un valor NULL.Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties Colección multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection La colección de propiedades extendidas de varios valores definidas para el mensaje.The collection of multi-value extended properties defined for the message. Admite un valor NULL.Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties Colección singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection La colección de propiedades extendidas de valor único definidas para el mensaje. Admite un valor NULL.The collection of single-value extended properties defined for the message. Nullable.

Representación JSONJSON representation

Aquí tiene una representación JSON del recursoHere is a JSON representation of the resource

{
  "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énSee also