tipo de recurso eventMessage
Espacio de nombres: microsoft.graph
Mensaje que representa una solicitud de reunión, cancelación o respuesta. Los valores posibles son acceptance, tentative acceptance o decline.
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 el ejemplo de obtener mensaje de evento. La aplicación también puede responder al evento en nombre del invitado mediante programación, aceptando, aceptando provisionalmente o rechazando el evento.
Aparte 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.
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 a un 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. |
| Datos adjuntos | ||
| 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 | Obtiene un objeto u objetos de extensión abierta identificados por nombre o por nombre completo. |
| 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. |
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. |
| 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.
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, 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 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 aún no se envía. |
| isRead | Booleano | Indica si se lee 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 anexar un ispopout argumento al final de la dirección URL para cambiar la forma en que 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 se establece en 0, el explorador muestra el mensaje en el panel de revisión de Outlook en la 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 de datos adjuntos | 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. |
| 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
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",
"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"
}