tipo de recurso eventMessage

Espacio de nombres: microsoft.graph

Un mensaje que representa una convocatoria, una cancelación o una respuesta de reunión (puede ser uno de los siguientes: aceptación, aceptación provisional o rechazo).

La entidad eventMessage se deriva de message. eventMessage es el tipo base de eventMessageRequest y eventMessageResponse. La propiedad meetingMessageType identifica el tipo de mensaje de evento.

Cuando un organizador o una aplicación envía una solicitud de reunión, la solicitud de reunión llega al buzón de un invitado como una instancia eventMessage con el meetingMessageType de meetingRequest. Además, Outlook crea automáticamente una instancia de evento en el calendario del invitado, con la propiedad showAs como provisional.

Para obtener las propiedades del evento asociado en el buzón del invitado, la aplicación puede usar la propiedad de navegación de eventos de eventMessage, como se muestra en este ejemplo de mensaje de evento get. La aplicación también puede responder al evento en nombre del invitado mediante programación, aceptando ,aceptando provisionalmente odeclinando el evento.

Aparte de una solicitud de reunión, se puede encontrar una instancia eventMessage en el buzón de un invitado como resultado de que un organizador de eventos cancele una reunión o en el buzón del organizador como resultado de que un invitado responda a la solicitud de reunión. Una aplicación puede actuar con los mensajes de evento casi de la misma forma que con los mensajes.

Métodos

Método Tipo de valor devuelto Descripción
Obtener eventMessage eventMessage Lee las propiedades y las relaciones del objeto eventMessage.
Actualizar eventMessage Actualiza el objeto eventMessage.
Delete Ninguno Elimina el objeto eventMessage.
copy message Copia un mensaje a una carpeta.
createForward message Crea un borrador del mensaje que de reenvío. Después puede actualizar o enviar el borrador.
createReply message Crea un borrador del mensaje de respuesta. Después puede actualizar o enviar el borrador.
createReplyAll message Crea un borrador del mensaje de respuesta a todos. Después puede actualizar o enviar el borrador.
forward Ninguno Reenvía un mensaje. El mensaje se guarda en la carpeta Elementos enviados.
move message 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 eventMessage.
Agregar datos adjuntos attachment Agrega datos adjuntos nuevos a un eventMessage al publicarlos 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 Obtiene un objeto u objetos de extensión abierta identificados por nombre o por nombre completo.
Propiedades extendidas
Crear propiedad extendida de valor único eventMessage Crea una o más propiedades extendidas de valor único en un eventMessage nuevo o existente.
Obtener eventMessage con propiedad extendida de valor único eventMessage Obtiene eventMessages que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.
Crear propiedad extendida de varios valores eventMessage Crea una o más propiedades extendidas de varios valores en un eventMessage nuevo o existente.
Obtener eventMessage con propiedad extendida de varios valores eventMessage Obtiene un eventMessage 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.
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.
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.
id Cadena Identificador único del mensaje de evento (tenga en cuenta que este valor puede cambiar si se mueve o modifica un mensaje)
importance String La importancia del mensaje: low, normal y high.
inferenceClassification String Los valores posibles son: focused , other .
internetMessageHeaders Colección internetMessageHeader Colección de encabezados de mensajes, definidos por RFC5322, que proporcionan los detalles de la ruta en la red que sigue un mensaje desde el remitente hasta el destinatario. Solo lectura.
internetMessageId String El identificador del mensaje en el formato especificado por RFC2822.
isDelegated Booleano True si esta solicitud de reunión es accesible para un delegado, false de lo contrario. El valor predeterminado es false.
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.
meetingMessageType meetingMessageType El tipo de mensaje de evento: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTenativelyAccepted, meetingDeclined.
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.
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.
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.
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 Solo lectura. Admite valores NULL.
evento event El evento asociado al mensaje de evento. La hipótesis de los asistentes o los recursos de la sala es que el Supervisor de calendario está configurado para actualizar el calendario automáticamente con un evento cuando lleguen mensajes de eventos de convocatoria de reunión. Propiedad de navegación. Solo lectura.
extensions Colección Extension La colección de extensiones abiertas definidas para el eventMessage. Solo lectura. Admite valores NULL.
multiValueExtendedProperties Colección multiValueLegacyExtendedProperty La colección de propiedades extendidas de varios valores definidas para el eventMessage. Solo lectura. Admite valores NULL.
singleValueExtendedProperties Colección singleValueLegacyExtendedProperty La colección de propiedades extendidas de valor único definidas para el eventMessage. Solo lectura. Admite valores 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": "DateTimeOffset",
  "event": { "@odata.type": "microsoft.graph.event" },
  "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",
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "meetingMessageType": "String",
  "parentFolderId": "string",
  "receivedDateTime": "DateTimeOffset",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "DateTimeOffset",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "webLink": "string"
}