tipo de recurso eventMessageeventMessage resource type

Importante

Las API de /beta la versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported.

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).A message that represents a meeting request, cancellation, or response (which can be one of the following: acceptance, tentative acceptance, or decline).

La entidad eventMessage se deriva de Message, y eventMessageRequest se deriva de eventMessage y representa una convocatoria de reunión.The eventMessage entity is derived from message, and, eventMessageRequest is derived from eventMessage and represents a meeting request. La propiedad meetingMessageType identifica el tipo de mensaje de evento.The meetingMessageType property identifies the type of the event message.

Cuando un organizador o aplicación envía una convocatoria de reunión, esta llega a la bandeja de entrada del asistente como instancia eventMessage con el meetingMessageType de meetingRequest.When an organizer or app sends a meeting request, the meeting request arrives in an attendee's Inbox as an eventMessage instance with the meetingMessageType of meetingRequest. Además, Outlook crea automáticamente una instancia event en el calendario del asistente con la propiedad showAs como provisional.In addition, Outlook automatically creates an event instance in the attendee's calendar, with the showAs property as tentative.

Para obtener las propiedades del evento asociado en el buzón del asistente, la aplicación puede usar la propiedad de navegación de evento del eventMessage, tal y como se muestra en este ejemplo de obtención de un mensaje de evento.To get the properties of the associated event in the attendee's mailbox, the app can use the event navigation property of the eventMessage, as shown in this get event message example. La aplicación también puede responder al evento en nombre del asistente mediante programación, aceptando, aceptando provisionalmenteo rechazando el evento. The app can also respond to the event on behalf of the attendee programmatically, by accepting, tentatively accepting, or declining the event.

Aparte de una convocatoria de reunión, se puede encontrar una instancia eventMessage en la carpeta Bandeja de entrada del asistente como resultado de la cancelación de una reunión del organizador de un evento o en la bandeja de entrada del organizador como resultado de un asistente que responde a la convocatoria de reunión.Aside from a meeting request, an eventMessage instance can be found in an attendee's Inbox folder as the result of an event organizer cancelling a meeting, or in the organizer's Inbox as a result of an attendee responding to the meeting request. Una aplicación puede actuar con los mensajes de evento casi de la misma forma que con los mensajes.An app can act on event messages in the same way as on messages with minor differences.

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": "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",
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isOutOfDate": "Boolean",
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "location": {"@odata.type": "microsoft.graph.location"},
  "meetingMessageType": {"@odata.type": "microsoft.graph.meetingMessageType"},
  "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"
}

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. Puede mostrarse en formato de texto o HTML.The body of the message. It can be in HTML or text format.
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 BinarioBinary Índice de la conversación a la que pertenece el correo electrónico.The Index of the conversation the email belongs to.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset La fecha y la hora de creación del mensaje.The date and time the message was created.
endDateTimeendDateTime dateTimeTimeZonedateTimeTimeZone La hora de finalización de la reunión solicitada.The end time of the requested meeting.
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 y el remitente del mensaje.The mailbox owner and sender of the message.
hasAttachmentshasAttachments BooleanoBoolean Indica si el mensaje tiene datos adjuntos.Indicates whether the message has attachments.
idid cadenaString Identificador único del mensaje.Unique identifier for the message. De forma predeterminada, este valor cambia cuando el elemento se mueve de un contenedor (como una carpeta o calendario) a otro.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Para cambiar este comportamiento, use el Prefer: IdType="ImmutableId" encabezado.To change this behavior, use the Prefer: IdType="ImmutableId" header. Consulte obtener identificadores inmutables para recursos de Outlook para obtener más información.See Get immutable identifiers for Outlook resources for more information.De sólo lectura.De forma predeterminada, este valor cambia cuando el elemento se mueve de un contenedor (como una carpeta o calendario) a otro.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Para cambiar este comportamiento, use el Prefer: IdType="ImmutableId" encabezado.To change this behavior, use the Prefer: IdType="ImmutableId" header. Consulte obtener identificadores inmutables para recursos de Outlook para obtener más información.See Get immutable identifiers for Outlook resources for more information. Read-only.
importanceimportance StringString La importancia del mensaje: low, normal y high.The importance of the message: low, normal, high.
inferenceClassificationinferenceClassification StringString Los valores posibles son focused y other.Possible values are: focused, other.
internetMessageHeadersinternetMessageHeaders Colección internetMessageHeaderinternetMessageHeader collection 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.The collection of message headers, defined by RFC5322, that provide details of the network path taken by a message from the sender to the recipient. Solo lectura.Read-only.
internetMessageIdinternetMessageId CadenaString Identificador del mensaje en el formato especificado por RFC5322.The message ID in the format specified by RFC5322.
isAllDayisAllDay BooleanoBoolean Indica si el evento dura todo el día.Indicates whether the event lasts the entire day. Para ajustar esta propiedad es necesario ajustar también las propiedades startDateTime y endDateTime del evento.Adjusting this property requires adjusting the startDateTime and endDateTime properties of the event as well.
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.
isOutOfDateisOutOfDate BooleanoBoolean Indica si la convocatoria de reunión se ha desactualizado con una solicitud más reciente.Indicates whether this meeting request has been made out-of-date by a more recent request.
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 Fecha y hora de la última modificación del mensaje.The date and time the message was last changed.
locationlocation ubicaciónlocation La ubicación de la reunión solicitada.The location of the requested meeting.
meetingMessageTypemeetingMessageType StringString El tipo de mensaje de evento: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTentativelyAccepted, meetingDeclined.The type of event message: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTentativelyAccepted, meetingDeclined.
parentFolderIdparentFolderId CadenaString 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.
recurrencerecurrence patternedRecurrencepatternedRecurrence El patrón de periodicidad de la reunión solicitada.The recurrence pattern of the requested meeting.
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.
sentDateTimesentDateTime DateTimeOffsetDateTimeOffset La fecha y la hora de envío del mensaje.The date and time the message was sent.
startDateTimestartDateTime dateTimeTimeZonedateTimeTimeZone La hora de inicio de la reunión solicitada.The start time of the requested meeting.
subjectsubject CadenaString 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.
typetype StringString El tipo de reunión solicitada singleInstance: occurence, exception, seriesMaster,.The type of requested meeting: singleInstance, occurence, exception, seriesMaster.
uniqueBodyuniqueBody itemBodyitemBody La parte del cuerpo del mensaje que es única del mensaje actual.The part of the body of the message that is unique to the current message.
UnsubscribeDataUnsubscribeData CadenaString Entradas válidas analizadas desde el encabezado List-Unsubscribe.The valid entries parsed from the List-Unsubscribe header. Son los datos del comando “mail” en el encabezado List-Unsubscribe si la propiedad UnsubscribeEnabled es “true”.This is the data for the mail command in the List-Unsubscribe header if UnsubscribeEnabled property is true.
UnsubscribeEnabledUnsubscribeEnabled BooleanoBoolean Indica si el mensaje permite cancelar la suscripción.Indicates whether the message is enabled for unsubscribe. Tiene un valor de “true” si el encabezado List-Unsubscribe cumple con rfc-2369.Its valueTrue if the list-Unsubscribe header conforms to rfc-2369.
webLinkwebLink StringString La dirección URL para abrir el mensaje en Outlook Web App.The URL to open the message in Outlook Web App.

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 se establece en 1, se muestra el mensaje en una ventana emergente. Si ispopout se establece en 0, el navegador mostrará el mensaje en el panel de revisión de Outlook Web App.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 Web App review pane.

El mensaje se abrirá en el navegador si está conectado a su buzón mediante Outlook Web App. Se le pedirá que inicie sesión si no la ha iniciado ya en el navegador.The message will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

Se puede acceder a esta dirección URL desde un iFrame.This URL can be accessed from within an iFrame.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
attachmentsattachments Colección attachmentattachment collection La colección de datos adjuntos fileAttachment, itemAttachmenty referenceAttachment del mensaje.The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the message. Solo lectura.Read-only. Admite un valor NULL.Nullable.
eventoevent eventevent 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.The event associated with the event message. The assumption for attendees or room resources is that the Calendar Attendant is set to automatically update the calendar with an event when meeting request event messages arrive. Navigation property. Read-only.
extensionsextensions Colección Extensionextension collection La colección de extensiones abiertas definidas para el eventMessage. Solo lectura. Admite valores NULL.The collection of open extensions defined for the eventMessage. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties Colección multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection La colección de propiedades extendidas de varios valores definidas para el eventMessage. Solo lectura. Admite valores NULL.The collection of multi-value extended properties defined for the eventMessage. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties Colección singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection La colección de propiedades extendidas de valor único definidas para el eventMessage. Solo lectura. Admite valores NULL.The collection of single-value extended properties defined for the eventMessage. Read-only. Nullable.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Obtener eventMessageGet eventMessage eventMessageeventMessage Lee las propiedades y las relaciones del objeto eventMessage.Read properties and relationships of eventMessage object.
ActualizarUpdate eventMessageeventMessage Actualiza el objeto eventMessage.Update eventMessage object.
DeleteDelete NoneNone Elimina el objeto eventMessage.Delete eventMessage object.
copycopy messagemessage Copia un mensaje a una carpeta.Copy a message to a folder.
createForwardcreateForward messagemessage 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 messagemessage 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 messagemessage 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.
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 messagemessage Mueve un mensaje a una carpeta. Se crea una nueva copia del mensaje en la carpeta de destino.Move a 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 Permite enviar 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.
unsubscribeunsubscribe NingunoNone Permite enviar un mensaje con los datos y la dirección especificados en el primer comando “mailto” en el encabezado List-Unsubscribe.Send a message using the data and address specified in the first mailto command in the List-Unsubscribe header.
AttachmentsAttachments
Enumerar datos adjuntosList attachments Colección attachmentattachment collection Obtiene todos los datos adjuntos en un eventMessage.Get all attachments on an eventMessage.
Agregar datos adjuntosAdd attachment dato adjuntoattachment Agrega datos adjuntos nuevos a un eventMessage al publicarlos en la colección de datos adjuntos.Add a new attachment to an eventMessage 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 una extensión abierta identificada por el nombre.Get an open extension identified by name.
Propiedades extendidasExtended properties
Crear propiedad extendida de valor únicoCreate single-value extended property eventMessageeventMessage Crea una o más propiedades extendidas de valor único en un eventMessage nuevo o existente.Create one or more single-value extended properties in a new or existing eventMessage.
Obtener eventMessage con propiedad extendida de valor únicoGet eventMessage with single-value extended property eventMessageeventMessage Obtiene eventMessages que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.Get eventMessages that contain a single-value extended property by using $expand or $filter.
Crear propiedad extendida de varios valoresCreate multi-value extended property eventMessageeventMessage Crea una o más propiedades extendidas de varios valores en un eventMessage nuevo o existente.Create one or more multi-value extended properties in a new or existing eventMessage.
Obtener eventMessage con propiedad extendida de varios valoresGet eventMessage with multi-value extended property eventMessageeventMessage Obtiene un eventMessage que contiene una propiedad extendida de varios valores mediante el uso de $expand.Get an eventMessage that contains a multi-value extended property by using $expand.