Acl: update

Actualiza una regla de control de acceso. Pruébalo ahora.

Solicitud

Solicitud HTTP

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta
calendarId string Es el identificador del calendario. Para recuperar los IDs de los calendarios, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario que accedió actualmente, usa la palabra clave "primary".
ruleId string Es el identificador de la regla de ACL.
Parámetros de consulta opcionales
sendNotifications boolean Indica si se deben enviar notificaciones sobre el cambio de uso compartido del calendario. Ten en cuenta que no hay notificaciones sobre la eliminación del acceso. Es opcional. El valor predeterminado es True.

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances:

Alcance
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso Acl con las siguientes propiedades:

Nombre de la propiedad Valor Descripción Notas
Propiedades obligatorias
scope object Es el alcance al que se otorga el acceso al calendario con esta regla de ACL.
scope.type string Es el tipo de alcance. Estos son los posibles valores:
  • "default" - El alcance público. Este es el valor predeterminado.
  • "user" - Limita el alcance a un solo usuario.
  • "group" - Limita el alcance a un grupo.
  • "domain" \- Limita el alcance a un dominio.
Nota: Los permisos otorgados al alcance "default" o público se aplican a cualquier usuario, autenticado o no.
Propiedades opcionales
role string Es el rol asignado al alcance. Estos son los posibles valores:
  • "none" - No proporciona acceso.
  • "freeBusyReader" - Proporciona acceso de lectura a la información de disponibilidad.
  • "reader" - Proporciona acceso de lectura al calendario. Los eventos privados aparecerán para los usuarios con acceso de lectura, pero los detalles del evento estarán ocultos.
  • "writerWithoutPrivateAccess" - Proporciona acceso de lectura y escritura al calendario. Los eventos privados aparecerán para los usuarios con acceso writerWithoutPrivateAccess, pero los detalles del evento estarán ocultos.
  • "writer" - Proporciona acceso de lectura y escritura al calendario. Los eventos privados aparecerán para los usuarios con acceso de escritura, y los detalles del evento estarán visibles. Proporciona acceso de lectura a las ACL del calendario.
  • "owner" - Proporciona acceso de administrador al calendario. Este rol tiene todos los permisos del rol de escritor con la capacidad adicional de modificar los niveles de acceso de otros usuarios.

admite escritura
scope.value string Es la dirección de correo electrónico de un usuario o grupo, o el nombre de un dominio, según el tipo de alcance. Se omite para el tipo "default". admite escritura

Respuesta

Si la respuesta es correcta, este método mostrará un recurso Acl en el cuerpo de la respuesta.

Pruébalo

Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos reales y ver la respuesta.