Tipo de recurso calendarPermission
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.
Permisos de un usuario con el que el calendario se ha compartido o delegado en un cliente de Outlook.
La lista, la creación, la obtención, la actualización y la eliminación de permisos de calendario solo se admiten en nombre del propietario del calendario.
Al obtener los permisos de calendario de un calendario en nombre de un destinatario o delegado del recurso compartido, se devuelve una colección de permisos de calendario vacía.
Una vez configurado un destinatario o delegado de recurso compartido para un calendario, solo puede actualizar la propiedad role para cambiar los permisos de un destinatario o delegado del recurso compartido. No se pueden actualizar las propiedades allowedRoles, emailAddress, isInsideOrganization o isRemovable . Para cambiar estas propiedades, debe eliminar el objeto calendarPermission correspondiente y crear otro destinatario o delegado del recurso compartido en un cliente de Outlook.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| List | calendarPermission | Obtenga una colección de objetos calendarPermission que describen la identidad y los roles de los usuarios con los que se ha compartido o delegado el calendario especificado. |
| Crear | calendarPermission | Create objeto calendarPermission. |
| Get | calendarPermission | Lee las propiedades y las relaciones del objeto calendarPermission. |
| Actualizar | calendarPermission | Actualice el objeto calendarPermission. |
| Delete | Ninguno | Eliminar objeto calendarPermission. |
Propiedades
| Propiedad | Tipo | Description |
|---|---|---|
| allowedRoles | calendarRoleType (colección) | Lista de niveles de permisos de delegación o uso compartido permitidos para el calendario. Los valores posibles son: none, freeBusyRead, limitedRead, read, write, delegateWithoutPrivateEventAccess, delegateWithPrivateEventAccess y custom. |
| emailAddress | emailAddress | Representa un destinatario o delegado del recurso compartido que tiene acceso al calendario. Para el destinatario del recurso compartido "Mi organización", la propiedad address es null. Solo lectura. |
| id | Cadena | Identificador único del usuario (destinatario o delegado del recurso compartido) con el que se ha compartido el calendario. Solo lectura. |
| isInsideOrganization | Booleano | True si el usuario en contexto (destinatario o delegado del recurso compartido) está dentro de la misma organización que el propietario del calendario. |
| isRemovable | Booleano |
True si el usuario se puede quitar de la lista de destinatarios o delegados para el calendario especificado, false en caso contrario. El usuario "Mi organización" determina los permisos que otras personas dentro de la organización tienen para el calendario especificado. No puede quitar "Mi organización" como destinatario de un calendario. |
| role | calendarRoleType | Nivel de permiso actual del destinatario o delegado del recurso compartido de calendario. |
valores calendarRoleType
| Member | Descripción |
|---|---|
| ninguno | El calendario no se comparte con el usuario. |
| freeBusyRead | El usuario es un destinatario del recurso compartido que puede ver el estado de disponibilidad del propietario en el calendario. |
| limitedRead | El usuario es un destinatario compartido que puede ver el estado de disponibilidad y los títulos y ubicaciones de los eventos en el calendario. |
| read | El usuario es un destinatario del recurso compartido que puede ver todos los detalles de los eventos en el calendario, excepto los eventos privados del propietario. |
| write | El usuario es un destinatario del recurso compartido que puede ver todos los detalles (excepto los eventos privados) y editar eventos en el calendario. |
| delegateWithoutPrivateEventAccess | El usuario es un delegado que tiene acceso de escritura, pero no puede ver información de los eventos privados del propietario en el calendario. |
| delegateWithPrivateEventAccess | El usuario es un delegado que tiene acceso de escritura y puede ver información de los eventos privados del propietario en el calendario. |
| Personalizado | El usuario tiene permisos personalizados para el calendario. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"allowedRoles": ["string"],
"emailAddress": {"@odata.type": "microsoft.graph.emailAddress"},
"id": "String (identifier)",
"isInsideOrganization": "boolean",
"isRemovable": "boolean",
"role": "string"
}