tipo de recurso calendarcalendar resource type

Un calendario que es un contenedor de eventos.A calendar which is a container for events. Puede ser el calendario de un usuario o el calendario predeterminado de un grupo de Office 365.It can be a calendar for a user, or the default calendar of an Office 365 group.

Nota: Hay algunas pequeñas diferencias en la forma en que puede interactuar con calendarios de usuario y calendarios de grupo:Note: There are a few minor differences in the way you can interact with user calendars and group calendars:

  • 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 se pueden aceptar, aceptar provisionalmente o rechazar convocatorias de reunión de 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 se pueden posponer o descartar los recordatorios de los 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
List calendarsList calendars calendar collectioncalendar collection Obtenga todos los calendarios del usuario o los calendarios en el grupo de calendarios predeterminado o en otro grupo de calendarios específico.Get all the user's calendars, or the calendars in the default or other specific calendar group.
Create calendarCreate calendar calendarcalendar Cree un calendario en el grupo de calendarios predeterminado o en el grupo de calendario especificado de un usuario.Create a new calendar in the default calendar group or specified calendar group for a user.
Get calendarGet calendar calendarcalendar Obtiene las propiedades y relaciones de un objeto de calendario.Get the properties and relationships of a calendar object. El calendario puede ser de un usuario o el calendario predeterminado de un grupo de Office 365.The calendar can be one for a user, or the default calendar of an Office 365 group.
UpdateUpdate calendarcalendar Actualiza las propiedades del objeto de calendario.Update the properties of a calendar object. El calendario puede ser de un usuario o el calendario predeterminado de un grupo de Office 365.The calendar can be one for a user, or the default calendar of an Office 365 group.
DeleteDelete NingunoNone Elimine el objeto de calendario.Delete calendar object.
List calendarViewList calendarView Colección eventevent collection Obtiene las repeticiones, excepciones e instancias únicas de eventos en una vista de calendario definida por un intervalo de tiempo del calendario principal del usuario (../me/calendarview) o de un calendario especificado.Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's primary calendar (../me/calendarview) or from a specified calendar.
List eventsList events Colección eventevent collection Permite recuperar una lista de eventos de un calendario. La lista contiene patrones de serie y reuniones de instancia única.Retrieve a list of events in a calendar. The list contains single instance meetings and series masters.
Create eventCreate event eventoevent Permite crear un evento en el calendario especificado o el predeterminado.Create a new event in the default or specified calendar.
getSchedulegetSchedule Colección scheduleInformationscheduleInformation collection Permite obtener información de disponibilidad de una colección de usuarios, listas de distribución o recursos en un período de tiempo especificado.Get the free/busy availability information for a collection of users, distributions lists, or resources, for a specified time period.
findMeetingTimesfindMeetingTimes meetingTimeSuggestionsResultmeetingTimeSuggestionsResult Permite sugerir ubicaciones y horas de reunión basándose en la disponibilidad del organizador y los asistentes, y las limitaciones de tiempo o ubicación.Suggest meeting times and locations based on organizer and attendee availability, and time or location constraints.
Crear propiedad extendida de valor únicoCreate single-value extended property calendarcalendar Cree una o varias propiedades extendidas de valor único en un calendario nuevo o existente.Create one or more single-value extended properties in a new or existing calendar.
Get calendar with single-value extended propertyGet calendar with single-value extended property calendarcalendar Obtenga calendarios que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter.Get calendars that contain a single-value extended property by using $expand or $filter.
Create multi-value extended propertyCreate multi-value extended property calendarcalendar Cree una o varias propiedades extendidas de varios valores en un calendario nuevo o existente.Create one or more multi-value extended properties in a new or existing calendar.
Get calendar with multi-value extended propertyGet calendar with multi-value extended property calendarcalendar Obtenga un calendario que contiene una propiedad extendida de varios valores mediante el uso de $expand.Get a calendar that contains a multi-value extended property by using $expand.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
canEditcanEdit BooleanoBoolean Es verdadero si el usuario puede escribir en el calendario; de lo contrario, es falso. Esta propiedad es verdadera para el usuario que creó el calendario. Esta propiedad también es verdadera para un usuario con quien se compartió un calendario y al que se concedió acceso de escritura.True if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who has been shared a calendar and granted write access.
canSharecanShare BooleanoBoolean Es verdadero si el usuario tiene permiso para compartir el calendario; de lo contrario, es falso. Solo el usuario que creó el calendario puede compartirlo.True if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it.
canViewPrivateItemscanViewPrivateItems BooleanoBoolean Es verdadero si el usuario puede leer elementos del calendario que se marcaron como privados; de lo contrario, es falso.True if the user can read calendar items that have been marked private, false otherwise.
changeKeychangeKey StringString Identifica la versión del objeto “calendar”. Cada vez que se cambia el calendario, también se cambia changeKey. Esto permite que Exchange aplique los cambios en la versión correcta del objeto. Solo lectura.Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.
colorcolor calendarColorcalendarColor Especifica el tema de color para distinguir el calendario de otros calendarios en una interfaz de usuario. Los valores de propiedad son: LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1Specifies the color theme to distinguish the calendar from other calendars in a UI. The property values are: LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1
idid StringString El identificador único del grupo. Solo lectura.The group's unique identifier. Read-only.
namename StringString El nombre del calendario.The calendar name.
ownerowner emailAddressemailAddress Si se establece, representa al usuario que creó o agregó el calendario. Para un calendario que el usuario creó o agregó, la propiedad owner se establece en el usuario. Para un calendario compartido con el usuario, la propiedad owner se establece en la persona que compartió el calendario con el usuario.If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user.

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
calendarViewcalendarView Event collectionEvent collection La vista Calendario del calendario. Propiedad Navigation. Solo lectura.The calendar view for the calendar. Navigation property. Read-only.
eventsevents Event collectionEvent collection Los eventos del calendario. Propiedad Navigation. Solo lectura.The events in the calendar. Navigation property. Read-only.
multiValueExtendedPropertiesmultiValueExtendedProperties Colección multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection La colección de propiedades extendidas de varios valores definidas para el calendario. Solo lectura. Admite valores NULL.The collection of multi-value extended properties defined for the calendar. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty collectionsingleValueLegacyExtendedProperty collection La colección de propiedades extendidas de valor único definidas para el calendario. Solo lectura. Admite valores NULL.The collection of single-value extended properties defined for the calendar. Read-only. Nullable.

Representación JSONJSON representation

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

{
  "canEdit": "boolean",
  "canShare": "boolean",
  "canViewPrivateItems": "boolean",
  "changeKey": "string",
  "color": "String",
  "id": "string (identifier)",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}