tipo de recurso eventevent resource type

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.

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

{
  "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,
  "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" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }]

}

Consulte tambiénSee also