tipo de recurso calendar
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa un contenedor para recursos del evento. Puede ser el calendario de un usuario o el calendario predeterminado de un grupo de Microsoft 365.
Nota: Hay algunas pequeñas diferencias en la forma en que puede interactuar con calendarios de usuario y calendarios de grupo:
- Solo se pueden organizar los calendarios de usuario en un elemento calendarGroup.
- Outlook acepta automáticamente todas las convocatorias de reunión en nombre de grupos. Puede aceptar, aceptar provisionalmente o rechazar solicitudes de reunión solo para calendarios de usuario.
- Outlook no admite los recordatorios para eventos de grupo. Solo se pueden posponer o descartar los recordatorios de los calendarios de usuario.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| List calendars | calendar collection | Obtenga todos los calendarios del usuario o los calendarios en el grupo de calendarios predeterminado o en otro grupo de calendarios específico. |
| Create calendar | calendar | Cree un calendario en el grupo de calendarios predeterminado o en el grupo de calendario especificado de un usuario. |
| Get calendar | calendar | Obtiene las propiedades y relaciones de un objeto de calendario. El calendario puede ser de un usuario o el calendario predeterminado de un grupo de Microsoft 365. |
| Actualizar | calendar | Actualiza las propiedades del objeto de calendario. El calendario puede ser de un usuario o el calendario predeterminado de un grupo de Microsoft 365. |
| Eliminar | Ninguno | Elimine el objeto de calendario. |
| List calendarView | Colección event | 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. |
| List events | Colección event | Recupere una lista de eventos de un calendario. La lista contiene patrones de serie y reuniones de instancia única. |
| Crear evento | evento | Permite crear un evento en el calendario especificado o el predeterminado. |
| getSchedule | Colección scheduleInformation | 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. |
| findMeetingTimes | meetingTimeSuggestionsResult | 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. |
| Crear propiedad extendida de valor único | calendar | Cree una o varias propiedades extendidas de valor único en un calendario nuevo o existente. |
| Get calendar with single-value extended property | calendar | Obtenga calendarios que contienen una propiedad extendida de valor único mediante el uso de $expand o $filter. |
| Create multi-value extended property | calendar | Cree una o varias propiedades extendidas de varios valores en un calendario nuevo o existente. |
| Get calendar with multi-value extended property | calendar | Obtenga un calendario que contiene una propiedad extendida de varios valores mediante el uso de $expand. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| allowedOnlineMeetingProviders | colección onlineMeetingProviderType | Representa los proveedores de servicios de reuniones en línea que se pueden usar para crear reuniones en línea en este calendario. Los valores posibles son: unknown, skypeForBusiness, skypeForConsumer y teamsForBusiness. |
| calendarGroupId | Cadena | El calendarGroup en el que crear el calendario. Si el usuario nunca ha establecido explícitamente un grupo para el calendario, esta propiedad es null. |
| canEdit | Booleano | true si el usuario puede escribir en el calendario, false lo contrario. Esta propiedad es true para el usuario que creó el calendario. Esta propiedad también es true para un usuario al que se le ha compartido un calendario y al que se le ha concedido acceso de escritura, a través de un cliente de Outlook o el correspondiente recurso calendarPermission. Solo lectura. |
| canShare | Booleano | Es true si el usuario tiene permiso para compartir el calendario; de lo contrario, es false. Solo el usuario que creó el calendario puede compartirlo. Solo lectura. |
| canViewPrivateItems | Booleano | Es true si el usuario puede leer elementos del calendario que se marcaron como privados; de lo contrario, es false. Esta propiedad se establece en un cliente de Outlook o en el recurso calendarPermission correspondiente. Solo lectura. |
| changeKey | String | Identifica la versión del objeto de calendario. Cada vez que se cambia el calendario, changeKey también cambia. Permite que Exchange aplique los cambios a la versión correcta del objeto. Solo lectura. |
| color | calendarColor | Especifica el tema de color para distinguir el calendario de otros calendarios en una interfaz de usuario. Los valores de propiedad son: auto. lightBlue. lightGreen. lightOrange. lightGray. lightYellow. lightTeal. lightPink. lightBrown. lightRed. maxColor. |
| defaultOnlineMeetingProvider | onlineMeetingProviderType | El proveedor de reuniones en línea predeterminado para reuniones enviadas desde este calendario. Los valores posibles son: unknown, skypeForBusiness, skypeForConsumer y teamsForBusiness. |
| hexColor | Cadena | El color del calendario, expresado en un código de color hexadecimal de tres valores hexadecimales, cada uno entre 00 y FF, y que representa los componentes rojo, verde y azul del color del espacio de color RGB. Si el usuario nunca ha establecido explícitamente un color para el calendario, esta propiedad está vacía. |
| id | Cadena | El identificador único del calendario. Solo lectura. |
| isDefaultCalendar | Booleano | Es true si este es el calendario predeterminado, en el que los nuevos eventos se crean de forma predeterminada, en caso contrario es false. |
| isRemovable | Booleano | Indica si se puede eliminar este calendario de usuario del buzón del usuario. |
| isShared | Booleano | true si el usuario ha compartido el calendario con otros usuarios; de lo contrario, false. Puesto que solo puede compartirlo el usuario que creó el calendario, isShared y isSharedWithMe no pueden ser true para el mismo usuario. Esta propiedad se establece cuando se inicia el uso compartido en un cliente de Outlook y se puede restablecer cuando se cancela el uso compartido a través del cliente o el recurso calendarPermission correspondiente. Solo lectura. |
| isSharedWithMe | Booleano | true si el usuario ha compartidos de calendario; de lo contrario, false. Esta propiedad siempre es false para un propietario de calendario. Esta propiedad se establece cuando se inicia el uso compartido en un cliente de Outlook y se puede restablecer cuando se cancela el uso compartido a través del cliente o el recurso calendarPermission correspondiente. Solo lectura. |
| isTallyingResponses | Booleano | Indica si este calendario de usuario es compatible con el seguimiento de las respuestas a reuniones. Solo las invitaciones a reuniones enviadas desde los calendarios principales de los usuarios admiten el seguimiento de las respuestas a reuniones. |
| name | String | El nombre del calendario. |
| owner | emailAddress | 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. Solo lectura. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| calendarPermissions | Colección calendarPermission | Los permisos de los usuarios con los que se comparte el calendario. |
| calendarView | Colección event | La vista Calendario del calendario. Propiedad Navigation. Solo lectura. |
| eventos | Colección event | Los eventos del calendario. Propiedad Navigation. Solo lectura. |
| multiValueExtendedProperties | Colección multiValueLegacyExtendedProperty | La colección de propiedades extendidas de varios valores definidas para el calendario. Solo lectura. Admite un valor NULL. |
| singleValueExtendedProperties | Colección singleValueLegacyExtendedProperty | La colección de propiedades extendidas de valor único definidas para el calendario. Solo lectura. Admite valores NULL. |
Representación JSON
La siguiente es una representación JSON del recurso
{
"allowedOnlineMeetingProviders": ["string"],
"canEdit": "boolean",
"canShare": "boolean",
"canViewPrivateItems": "boolean",
"changeKey": "string",
"color": "String",
"defaultOnlineMeetingProvider": "string",
"hexColor": "String",
"id": "string (identifier)",
"isDefaultCalendar": "boolean",
"isRemovable": "boolean",
"isShared": "boolean",
"isSharedWithMe": "boolean",
"isTallyingResponses": "boolean",
"name": "string",
"owner": {"@odata.type": "microsoft.graph.emailAddress"}
}
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de