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	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 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"
}