tipo de recurso eventevent 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.

Puede ser un calendario de usuario o el calendario predeterminado de un grupo de Office 365.An event in a user calendar, or the default calendar of an Office 365 group.

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.
  • 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.

Representación JSONJSON representation

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

{
  "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,
  "uid": "string",
  "id": "string (identifier)",
  "importance": "String",
  "isAllDay": true,
  "isCancelled": true,
  "isOrganizer": true,
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "locations": [{"@odata.type": "microsoft.graph.location"}],
  "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",
  "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" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }]
}

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
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. Cada categoría se corresponde con la propiedad displayName de un elemento outlookCategory definido para el usuario.Each category corresponds to the displayName property of an outlookCategory defined for the user.
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'
endend 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.
idid CadenaString Identificador único del evento.Unique identifier for the classification. 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. Solo 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.
importanceimportance StringString Importancia del evento.The importance of the event. Los valores posibles son: low, normal y high.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.
isOrganizerisOrganizer BooleanoBoolean Se establece como true si el remitente del mensaje también es el organizador.Set to true if the message sender is also the organizer.
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 LocationLocation 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.
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 reunión en línea (por ejemplo, Skype).The property is set only when an organizer specifies an event as an online meeting such as Skype. Solo lectura.Read-only.
organizerorganizer 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.
recurrencerecurrence 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 BooleanoBoolean Se establece como true si el remitente quiere una respuesta cuando el evento se acepta o se rechaza.Set to true if the sender would like a response when the event is accepted or declined.
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 StringString Los valores posibles son: normal, personal, private y confidential.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 StringString El estado que se mostrará.The status to show. Los valores posibles son: free, tentative, busy, oof, workingElsewhere, unknown.Possible values are: free, tentative, busy, oof, workingElsewhere, unknown.
startstart DateTimeTimeZoneDateTimeTimeZone La fecha de inicio, la hora y la zona horaria del 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.
typetype StringString El tipo de evento.The event type. Los valores posibles son: singleInstance, occurrence, exception y seriesMaster.Possible values are: singleInstance, occurrence, exception, seriesMaster. Solo lecturaRead-only
uiduid CadenaString Un identificador único que comparten todas las instancias de un evento a través de calendarios diferentes.A unique identifier that is shared by all instances of an event across different calendars. Nota: Esta propiedad tiene la misma finalidad que la propiedad iCalUid en el recurso event en el punto de conexión de la versión 1.0, pero no se garantiza que tenga el mismo valor.Note: this property serves the same purpose as the iCalUid property on the event resource on the v1.0 endpoint, but is not guaranteed to have the same value.
webLinkwebLink StringString La dirección URL para abrir el evento en Outlook Web App.The URL to open the event in Outlook Web App.

El evento 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 event 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, ItemAttachment y referenceAttachment del evento.The collection of FileAttachment, ItemAttachment, and referenceAttachment attachments for the event. Propiedad de navegación.Navigation property. Solo lectura.Read-only. Admite valores NULL.Nullable.
calendarcalendar CalendarCalendar 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. Admite valores NULL.Nullable.
instancesinstances Colección eventEvent collection 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 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.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Lista de eventosList events Colección eventEvent collection Recupera una lista de los objetos event 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.
cancelcancel NingunoNone Envía un mensaje de cancelación del organizador a todos los asistentes y elimina la reunión especificada.Send cancellation message from the organizer to all the attendees and cancel the specified meeting.
acceptaccept 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.
forwardforward NingunoNone Permite al organizador o al asistente de un evento de reunión reenviar la solicitud de reunión a un nuevo destinatario.Lets the organizer or attendee of a meeting event forward the meeting request to a new recipient.
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 una colección de objetos de evento.Get a Event object collection.
AttachmentsAttachments
Enumerar datos adjuntosList attachments Colección attachmentAttachment collection Obtiene todos los datos adjuntos en un evento.Get all attachments on an event.
Agregar datos adjuntosAdd attachment AttachmentAttachment Agrega nuevos datos adjuntos 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 un recurso existente.Create an open extension and add custom properties to a new or existing resource.
Obtener extensión abiertaGet open extension Colección openTypeExtensionopenTypeExtension collection Obtiene una extensión abierta identificada por el nombre de extensión.Get an open extension identified by the extension name.
Extensiones de esquemaSchema extensions
Agregar valores de extensión de esquemaAdd schema extension values Cree una definición de extensión de esquema y, después, úsela para agregar datos escritos personalizados a un recurso.Create a schema extension definition and then use it to add custom typed data to a resource.
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 $expand.Get an event that contains a multi-value extended property by using $expand.

Vea tambiénSee also