tipo de recurso de eventoevent resource type

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Un evento en un calendario de usuario o el calendario predeterminado de un grupo de Microsoft 365.An event in a user calendar, or the default calendar of a Microsoft 365 group.

El número máximo de asistentes incluidos en un event y el número máximo de destinatarios en un eventMessage enviado desde un buzón de Exchange Online es 500.The maximum number of attendees included in an event , and the maximum number of recipients in an eventMessage 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:

Nota: Hay algunas diferencias menores en la forma en que puede interactuar con los calendarios de usuario, grupo y sus eventos:Note: There are a few minor differences in the way you can interact with user calendars, group calendars, and their events:

  • Solo se pueden organizar los calendarios de usuario en un elemento calendarGroup.You can organize only user calendars in a calendarGroup.
  • Puede agregar objetos de datos adjuntos a eventos de calendarios de usuario, pero no a eventos de calendarios de grupo.You can add attachment objects to events in only user calendars, but not to events in group calendars.
  • Outlook acepta automáticamente todas las convocatorias de reunión en nombre de grupos.Outlook automatically accepts all meeting requests on behalf of groups. Solo puede aceptar, aceptar provisionalmente o rechazar convocatorias de reunión en calendarios de usuario .You can accept, tentatively accept, or decline meeting requests for user calendars only.
  • Outlook no admite los recordatorios para eventos de grupo.Outlook doesn't support reminders for group events. Solo puede posponer o descartar un aviso en calendarios de usuario .You can snooze or dismiss a reminder for user calendars only.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Enumerar eventosList events Colección eventevent collection Recupere una lista de los objetos de evento del buzón del usuario. La lista contiene patrones de serie y reuniones de instancia única.Retrieve a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
Crear eventoCreate event eventoevent Crea un nuevo evento publicando en la colección de instancias.Create a new event by posting to the instances collection.
Obtener eventoGet event eventoevent Lee las propiedades y las relaciones del objeto de evento.Read properties and relationships of event object.
ActualizarUpdate eventoevent Actualiza el mensaje de evento.Update event object.
EliminarDelete NingunoNone Elimina el objeto de evento.Delete event object.
Aceptaraccept NingunoNone Acepta el evento especificado en un calendario de usuario.Accept the specified event in a user calendar.
tentativelyAccepttentativelyAccept NingunoNone Acepta provisionalmente el evento especificado en un calendario de usuario.Tentatively accept the specified event in a user calendar.
declinedecline NingunoNone Rechaza la invitación al evento especificado en un calendario de usuario.Decline invitation to the specified event in a user calendar.
deltadelta Colección eventevent collection Obtenga un conjunto de eventos que se han agregado, eliminado o actualizado en una calendarView (un intervalo de eventos) del calendario principal del usuario.Get a set of events that have been added, deleted, or updated in a calendarView (a range of events) of the user's primary calendar.
dismissReminderdismissReminder NingunoNone Descarta el aviso para el evento especificado en un calendario de usuario.Dismiss the reminder for the specified event in a user calendar.
snoozeRemindersnoozeReminder NingunoNone Pospone un aviso para el evento especificado en el calendario del usuario hasta una nueva hora.Postpone a reminder for the specified event in a user calendar until a new time.
List instancesList instances Colección eventevent collection Obtiene las instancias (repeticiones) de un evento durante un intervalo de tiempo especificado. Si el evento es de tipo SeriesMaster, devuelve las repeticiones y excepciones del evento en el intervalo de tiempo especificado.Get the instances (occurrences) of an event for a specified time range. If the event is a SeriesMaster type, this returns the occurrences and exceptions of the event in the specified time range.
Datos adjuntosAttachments
Enumerar datos adjuntosList attachments Colección attachmentattachment collection Obtener todos los datos adjuntos en un evento.Get all attachments on an event.
Agregar datos adjuntosAdd attachment dato adjuntoattachment Agrega datos adjuntos nuevos a un evento al publicarlos en la colección de datos adjuntos.Add a new attachment to an event 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 Obtiene 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.
Propiedades extendidasExtended properties
Crear propiedad extendida de valor únicoCreate single-value extended property eventoevent Crea una o más propiedades extendidas de valor único en un evento nuevo o existente.Create one or more single-value extended properties in a new or existing event.
Obtener evento con propiedad extendida de valor únicoGet event with single-value extended property eventoevent Obtiene eventos que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.Get events that contain a single-value extended property by using $expand or $filter.
Crear propiedad extendida de varios valoresCreate multi-value extended property eventoevent Crea una o más propiedades extendidas de varios valores en un evento nuevo o existente.Create one or more multi-value extended properties in a new or existing event.
Obtener evento con propiedad extendida de varios valoresGet event with multi-value extended property eventoevent Obtiene un evento que contiene una propiedad extendida de varios valores mediante el uso de $expand.Get an event that contains a multi-value extended property by using $expand.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
allowNewTimeProposalsallowNewTimeProposals BooleanBoolean True si el organizador de la reunión permite a los invitados proponer una nueva hora en la respuesta. En caso contrario false.True if the meeting organizer allows invitees to propose a new time when responding, false otherwise. Opcional.Optional. El valor predeterminado es true.Default is true.
attendeesattendees Colección attendeeattendee collection La colección de asistentes del evento.The collection of attendees for the event.
bodybody itemBodyitemBody El cuerpo del mensaje asociado al evento. Puede mostrarse en formato de texto o HTML.The body of the message associated with the event. It can be in HTML or text format.
bodyPreviewbodyPreview StringString La vista previa del mensaje asociado al evento. Se muestran en formato de texto.The preview of the message associated with the event. It is in text format.
categoriescategories Colección stringString collection Las categorías asociadas al evento.The categories associated with the event.
changeKeychangeKey StringString Identifica la versión del objeto de evento. Cada vez que cambia el evento, cambia también ChangeKey. Esto permite que Exchange aplique los cambios a la versión correcta del objeto.Identifies the version of the event object. Every time the event is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre pertenecen a la zona horaria UTC. Por ejemplo, medianoche en la zona horaria UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
finalizaciónend dateTimeTimeZonedateTimeTimeZone La fecha, la hora y la zona horaria en que finaliza el evento.The date, time, and time zone that the event ends. De manera predeterminada, la hora de finalización está en formato UTC.By default, the end time is in UTC.
hasAttachmentshasAttachments BooleanoBoolean Se establece como true si el evento tiene datos adjuntos.Set to true if the event has attachments.
iCalUIdiCalUId StringString Un identificador único para un evento entre calendarios.A unique identifier for an event across calendars. Este id. es diferente para cada repetición en una serie periódica.This ID is different for each occurrence in a recurring series. Solo lectura.Read-only.
idid CadenaString Solo lectura.Read-only.
importanceimportance importanceimportance Importancia del evento.The importance of the event. Los valores posibles son: low, normal, high.The possible values are: low, normal, high.
isAllDayisAllDay BooleanoBoolean Se establece como true si el evento dura todo el día.Set to true if the event lasts all day.
isCancelledisCancelled BooleanoBoolean Se establece como true si el evento ha sido cancelado.Set to true if the event has been canceled.
IsOnlineMeetingisOnlineMeeting BooleanBoolean True si este evento tiene información de reuniones en línea, false en caso contrario.True if this event has online meeting information, false otherwise. El valor predeterminado es false.Default is false. Opcional.Optional.
isOrganizerisOrganizer BooleanoBoolean Se establece en true si el propietario del calendario (especificado por la propiedad owner de calendar) es el organizador del evento (especificado por la propiedad organizer del event ).Set to true if the calendar owner (specified by the owner property of the calendar) is the organizer of the event (specified by the organizer property of the event ). Esto también se aplica si un delegado organizó el evento en nombre del propietario.This also applies if a delegate organized the event on behalf of the owner.
isReminderOnisReminderOn BooleanoBoolean Se establece como true si se crea una alerta para recordarle el evento al usuario.Set to true if an alert is set to remind the user of the event.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre pertenecen a la zona horaria UTC. Por ejemplo, medianoche en la zona horaria UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
locationlocation ubicaciónlocation La ubicación del evento.The location of the event.
locationslocations Colección locationlocation collection Ubicaciones donde se celebra el evento o en las que se asiste.The locations where the event is held or attended from. Las propiedades location y locations siempre se corresponden entre sí.The location and locations properties always correspond with each other. Si se actualiza la propiedad location , se eliminarían las ubicaciones anteriores de la colección locations y se reemplazarían por el nuevo valor de location .If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.
onlineMeetingonlineMeeting OnlineMeetingInfoOnlineMeetingInfo Detalles para que un asistente participe en la reunión en línea.Details for an attendee to join the meeting online. Solo lectura.Read-only.
onlineMeetingProvideronlineMeetingProvider onlineMeetingProviderTypeonlineMeetingProviderType Representa el proveedor de servicios de reuniones en línea.Represents the online meeting service provider. Los valores posibles son teamsForBusiness, skypeForBusiness y skypeForConsumer.The possible values are teamsForBusiness, skypeForBusiness, and skypeForConsumer. Opcional.Optional.
onlineMeetingUrlonlineMeetingUrl StringString Una dirección URL para una reunión en línea.A URL for an online meeting. Solo se establece la propiedad cuando el organizador especifica un evento como una reunión en línea (por ejemplo, una reunión de Skype).The property is set only when an organizer specifies an event as an online meeting such as a Skype meeting. Solo lectura.Read-only.
organizadororganizer recipientrecipient El organizador del evento.The organizer of the event.
originalEndTimeZoneoriginalEndTimeZone CadenaString Zona horaria de finalización que se estableció cuando se creó el evento.The end time zone that was set when the event was created. Un valor de tzone://Microsoft/Custom indica que se ha establecido una zona horaria heredada en el cliente de escritorio de Outlook.A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
originalStartoriginalStart DateTimeOffsetDateTimeOffset El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre pertenecen a la zona horaria UTC. Por ejemplo, medianoche en la zona horaria UTC del 1 de enero de 2014 sería así: '2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
originalStartTimeZoneoriginalStartTimeZone StringString La zona horaria de inicio que se estableció cuando se creó el evento. Un valor de tzone://Microsoft/Custom indica que se ha establecido una zona horaria legado en el cliente de escritorio de Outlook.The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
periodicidadrecurrence patternedRecurrencepatternedRecurrence El patrón de periodicidad del evento.The recurrence pattern for the event.
reminderMinutesBeforeStartreminderMinutesBeforeStart Int32Int32 El número de minutos antes de la hora de inicio del evento en que se producirá la alerta del recordatorio.The number of minutes before the event start time that the reminder alert occurs.
responseRequestedresponseRequested BooleanBoolean El valor predeterminado es verdadero. Esto indica que el organizador quiere que un invitado envíe una respuesta al evento.Default is true, which represents the organizer would like an invitee to send a response to the event.
responseStatusresponseStatus responseStatusresponseStatus Indica el tipo de respuesta que se envía en respuesta a un mensaje de evento.Indicates the type of response sent in response to an event message.
confidencialidadsensitivity sensitivitysensitivity Los valores posibles son: normal, personal, private, confidential.The possible values are: normal, personal, private, confidential.
seriesMasterIdseriesMasterId CadenaString Identificador del elemento de patrón de serie periódica, si el evento forma parte de una serie periódica.The ID for the recurring series master item, if this event is part of a recurring series.
showAsshowAs freeBusyStatusfreeBusyStatus El estado que se mostrará.The status to show. Los valores posibles son: free, tentative, busy, oof, workingElsewhere, unknown.The possible values are: free, tentative, busy, oof, workingElsewhere, unknown.
startstart dateTimeTimeZonedateTimeTimeZone La fecha, la hora y la zona horaria en que comienza el evento.The date, time, and time zone that the event starts. De manera predeterminada, la hora de inicio está en formato UTC.By default, the start time is in UTC.
subjectsubject StringString El texto de la línea de asunto del evento.The text of the event's subject line.
transactionIdtransactionId StringString Un identificador personalizado especificado por una aplicación cliente para el servidor para evitar operaciones de registro redundantes en caso de que el cliente vuelva a intentar crear el mismo evento.A custom identifier specified by a client app for the server to avoid redundant POST operations in case of client retries to create the same event. Esto es útil cuando la conectividad de red baja hace que el cliente agote el tiempo de espera antes de recibir una respuesta del servidor para la solicitud previa de creación de eventos del cliente.This is useful when low network connectivity causes the client to time out before receiving a response from the server for the client's prior create-event request. Después de establecer transactionId al crear un evento, no se puede cambiar transactionId en una actualización posterior.After you set transactionId when creating an event, you cannot change transactionId in a subsequent update. Esta propiedad se devuelve solo en una carga de respuesta si una aplicación la ha configurado.This property is only returned in a response payload if an app has set it. Opcional.Optional.
typetype eventTypeeventType El tipo de evento.The event type. Los valores posibles son: singleInstance, occurrence, exception, seriesMaster.The possible values are: singleInstance, occurrence, exception, seriesMaster. Solo lectura.Read-only.
webLinkwebLink CadenaString Dirección URL para abrir el evento en Outlook en la web.The URL to open the event in Outlook on the web.

Outlook en la Web abre el evento en el explorador si ha iniciado sesión en su buzón.Outlook on the web opens the event in the browser if you are signed in to your mailbox. En caso contrario, Outlook en la Web le pedirá que inicie sesión.Otherwise, Outlook on the web prompts you to sign in.

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

Nota

La propiedad webLink especifica una dirección URL que abre el evento solo en versiones anteriores de Outlook en la Web.The webLink property specifies a URL that opens the event in only earlier versions of Outlook on the web. Los formatos de dirección URL son los siguientes, donde {Id. de evento} es el valor codificado de la dirección URL de la propiedad id :The following are the URL formats, with {event-id} being the URL-encoded value of the id property:

  • Para cuentas de trabajo o escuela: https://outlook.office365.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/itemFor work or school accounts: https://outlook.office365.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item

  • Para cuentas de Microsoft: https://outlook.live.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/itemFor Microsoft accounts: https://outlook.live.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item

Para abrir el evento en una versión actual de Outlook en la Web, convierta la dirección URL a uno de los siguientes formatos y use esa URL para abrir el evento:To open the event in a current version of Outlook on the web, convert the URL to one of the following formats, and use that URL to open the event:

  • Para cuentas de trabajo o escuela: https://outlook.office365.com/calendar/item/{event-id}For work or school accounts: https://outlook.office365.com/calendar/item/{event-id}

  • Para cuentas de Microsoft: https://outlook.live.com/calendar/item/{event-id}For Microsoft accounts: https://outlook.live.com/calendar/item/{event-id}

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
attachmentsattachments Colección attachmentattachment collection La colección de datos adjuntos fileAttachment y itemAttachment del evento. Propiedad de navegación. Solo lectura. Admite valores NULL.The collection of fileAttachment and itemAttachment attachments for the event. Navigation property. Read-only. Nullable.
calendariocalendar calendariocalendar El calendario que contiene el evento. Propiedad de navegación. Solo lectura.The calendar that contains the event. Navigation property. Read-only.
extensionsextensions Colección ExtensionExtension collection La colección de extensiones abiertas definidas para el evento.The collection of open extensions defined for the event. Solo lectura.Read-only. Admite valores NULL.Nullable.
instancesinstances Colección eventevent collection Las instancias del evento. Propiedad de navegación. Solo lectura. Admite valores NULL.The instances of the event. Navigation property. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties Colección multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection La colección de propiedades extendidas de varios valores definidas para el evento. Solo lectura. Admite valores NULL.The collection of multi-value extended properties defined for the event. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties Colección singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection La colección de propiedades extendidas de valor único definidas para el evento. Solo lectura. Admite valores NULL.The collection of single-value extended properties defined for the event. Read-only. Nullable.

Representación JSONJSON representation

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

{
  "allowNewTimeProposals": "Boolean",
  "attendees": [{"@odata.type": "microsoft.graph.attendee"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "changeKey": "string",
  "createdDateTime": "String (timestamp)",
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "iCalUId": "string",
  "id": "string (identifier)",
  "importance": "String",
  "isAllDay": true,
  "isCancelled": true,
  "isOnlineMeeting": true,
  "isOrganizer": true,
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "locations": [{"@odata.type": "microsoft.graph.location"}],
  "onlineMeeting": {"@odata.type": "microsoft.graph.onlineMeetingInfo"},
  "onlineMeetingProvider": "string",
  "onlineMeetingUrl": "string",
  "organizer": {"@odata.type": "microsoft.graph.recipient"},
  "originalEndTimeZone": "string",
  "originalStart": "String (timestamp)",
  "originalStartTimeZone": "string",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderMinutesBeforeStart": 1024,
  "responseRequested": true,
  "responseStatus": {"@odata.type": "microsoft.graph.responseStatus"},
  "sensitivity": "String",
  "seriesMasterId": "string",
  "showAs": "String",
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "transactionId": "string",
  "type": "String",
  "webLink": "string",

  "attachments": [ { "@odata.type": "microsoft.graph.attachment" } ],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "extensions": [ { "@odata.type": "microsoft.graph.extension" } ],
  "instances": [ { "@odata.type": "microsoft.graph.event" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }]

}

Consulte tambiénSee also