Tipo de recurso calendarPermission

Espacio de nombres: microsoft.graph

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, se devuelve una colección de permisos de calendario vacíos.

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. 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 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 Crear objeto calendarPermission.
Obtener calendarPermission calendarPermission Lee las propiedades y las relaciones del objeto calendarPermission.
Actualizar calendarPermission Actualice el objeto calendarPermission.
Delete Ninguno Eliminar objeto calendarPermission.

Propiedades

Propiedad Tipo Descripción
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) con el que se ha compartido el calendario. Solo lectura.
isInsideOrganization Booleano True si el usuario en contexto (destinatario o delegado) 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 del recurso compartido a 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 que puede ver el estado de disponibilidad del propietario en el calendario.
limitedRead El usuario es un destinatario 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 que puede ver todos los detalles de los eventos en el calendario, excepto los eventos privados del propietario.
write El usuario es un destinatario 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"
}