tipo de recurso eventMessage

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Mensaje que representa una solicitud de reunión, cancelación o respuesta. Puede ser uno de los siguientes valores: aceptación, aceptación provisional o rechazo.

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

Cuando un organizador o una aplicación envía una convocatoria de reunión, la convocatoria 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 o rechazando el evento.

Además de una convocatoria de reunión, se puede encontrar una instancia de 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.

Representación JSON

La siguiente representación JSON muestra el tipo de 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",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "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",
  "isAllDay": "Boolean",
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isOutOfDate": "Boolean",
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "location": {"@odata.type": "microsoft.graph.location"},
  "meetingMessageType": {"@odata.type": "microsoft.graph.meetingMessageType"},
  "mentionsPreview": {"@odata.type": "microsoft.graph.mentionsPreview"},
  "parentFolderId": "string",
  "receivedDateTime": "DateTimeOffset",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "DateTimeOffset",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "type": "string",
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "UnsubscribeData": "string",
  "UnsubscribeEnabled": true,
  "webLink": "string"
}

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 muestra 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.
endDateTime	dateTimeTimeZone	Hora de finalización de la reunión solicitada.
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 forma predeterminada, este valor cambia cuando el elemento se mueve de un contenedor (como una carpeta o un calendario) a otro. Para cambiar este comportamiento, use el encabezado Prefer: IdType="ImmutableId". Vea Obtener identificadores inmutables para recursos de Outlook para obtener más información. Solo lectura.
importance	String	La importancia del mensaje: low, normal y high.
inferenceClassification	String	Los valores posibles son: focused y 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	Cadena	Identificador del mensaje en el formato especificado por RFC5322.
isAllDay	Booleano	Indica si el evento dura todo el día. El ajuste de esta propiedad requiere ajustar también las propiedades startDateTime y endDateTime del evento.
isDelegated	Booleano	True si un delegado puede acceder a esta solicitud de reunión; en caso contrario, false. 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.
isOutOfDate	Booleano	Indica si esta solicitud de reunión se ha realizado desactualizadas por una solicitud más reciente.
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.
location	ubicación	Ubicación de la reunión solicitada.
meetingMessageType	Cadena	El tipo de mensaje de evento: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTentativelyAccepted, meetingDeclined.
mentionsPreview	mentionsPreview	Obtiene información sobre las menciones de un mensaje. Al procesar una solicitud GET /messages, el servidor establece esta propiedad y la incluye de forma predeterminada en la respuesta. El servidor devuelve NULL si no hay menciones en el mensaje. Opcional.
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.
recurrence	patternedRecurrence	Patrón de periodicidad de la reunión solicitada.
replyTo	Colección recipient	Las direcciones de correo electrónico que se utilizan al responder.
sender	recipient	Cuenta que se usa 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. Para obtener más información, vea establecer las propiedades from y sender.
sentDateTime	DateTimeOffset	La fecha y la hora de envío del mensaje.
startDateTime	dateTimeTimeZone	Hora de inicio de la reunión solicitada.
subject	String	El asunto del mensaje.
toRecipients	Colección recipient	Los destinatarios Para: del mensaje.
type	Cadena	Tipo de reunión solicitada: singleInstance, occurence, exception, seriesMaster.
uniqueBody	itemBody	La parte del cuerpo del mensaje que es única del mensaje actual.
UnsubscribeData	Cadena	Entradas válidas analizadas desde el encabezado List-Unsubscribe. Son los datos del comando “mail” en el encabezado List-Unsubscribe si la propiedad UnsubscribeEnabled es “true”.
UnsubscribeEnabled	Booleano	Indica si el mensaje permite cancelar la suscripción. Tiene un valor de “true” si el encabezado List-Unsubscribe cumple con rfc-2369.
webLink	String	La dirección URL para abrir el mensaje en Outlook en la Web. Puede anexar un argumento ispopout al final de la dirección URL para cambiar cómo se muestra el mensaje. Si ispopout no está presente o si está establecido en 1, el mensaje se muestra en una ventana emergente. Si ispopout está establecido en 0, el explorador muestra el mensaje en outlook en el panel de revisión web. El mensaje se abre en el explorador si ha iniciado sesión en el buzón a través de Outlook en la web. Se le pedirá que inicie sesión si aún no ha iniciado sesión con el explorador. No se puede acceder a esta dirección URL desde dentro de un iFrame.

Relaciones

Relación	Tipo	Descripción
attachments	Colección attachment	Colección de datos adjuntos fileAttachment, itemAttachment y referenceAttachment para el mensaje. 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 de extensiones	Colección de extensiones abiertas definidas para eventMessage. Solo lectura. Admite valores NULL.
mentions	Colección mention	Colección de menciones en el mensaje, ordenadas por el elemento createdDateTime desde el más reciente al más antiguo. De forma predeterminada, / GET messages no devuelve esta propiedad a menos que se aplique $expand a la propiedad .
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.

Métodos

Método	Tipo de valor devuelto	Descripción
Get	eventMessage	Lee las propiedades y las relaciones del objeto eventMessage.
Actualizar	eventMessage	Actualiza el objeto eventMessage.
Eliminar	Ninguno	Elimina el objeto eventMessage.
Copiar mensaje	message	Copia un mensaje a una carpeta.
Crear borrador para reenviar el mensaje	message	Crea un borrador del mensaje que de reenvío. Después, puede actualizar o enviar el borrador.
Crear borrador para responder	message	Crea un borrador del mensaje de respuesta. Después, puede actualizar o enviar el borrador.
Crear borrador para responder a todos	message	Crea un borrador del mensaje de respuesta a todos. Después, puede actualizar o enviar el borrador.
Reenviar mensaje	Ninguno	Reenvía un mensaje. El mensaje se guarda en la carpeta Elementos enviados.
Mover mensaje	message	Mueve un mensaje a una carpeta. Se crea una nueva copia del mensaje en la carpeta de destino.
Responder a un mensaje	Ninguno	Responde al remitente de un mensaje. El mensaje se guarda en la carpeta Elementos enviados.
Responder a todos al mensaje	Ninguno	Responde a todos los remitentes de un mensaje. El mensaje se guarda en la carpeta Elementos enviados.
Enviar borrador de mensaje	Ninguno	Envía un borrador de mensaje creado anteriormente. El mensaje se guarda en la carpeta Elementos enviados.
Mensaje de recuperación	message	Recupere un mensaje en la carpeta Elementos enviados del buzón de usuario especificado.
Unsubscribe	Ninguno	Permite enviar un mensaje con los datos y la dirección especificados en el primer comando “mailto” en el encabezado List-Unsubscribe.
Eliminar permanentemente	Ninguno	Elimine permanentemente un mensaje de evento y colócado en la carpeta Purgas de la carpeta Elementos recuperables del buzón del usuario.
Attachments
Enumerar datos adjuntos	Colección de datos adjuntos	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	Obtenga una extensión abierta identificada por su nombre.
Propiedades extendidas
Crear una propiedad de valor único	eventMessage	Crea una o más propiedades extendidas de valor único en un eventMessage nuevo o existente.
Obtener una propiedad de valor único	eventMessage	Obtiene eventMessages que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.
Creación de una propiedad de varios valores	eventMessage	Crea una o más propiedades extendidas de varios valores en un eventMessage nuevo o existente.
Obtención de la propiedad multivalor	eventMessage	Obtiene un eventMessage que contiene una propiedad extendida de varios valores mediante el uso de $expand.