Actualiza una regla de control de acceso. Pruébalo ahora y ve un ejemplo.
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 de acceso | ||
calendarId |
string |
Es el identificador de calendario. Para recuperar los ID del calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario que accedió, usa "primary " palabra clave.
|
ruleId |
string |
Identificador de la regla de LCA. |
Parámetros de consulta opcionales | ||
sendNotifications |
boolean |
Establece 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. Opcional. El valor predeterminado es True. |
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
Alcance |
---|
https://www.googleapis.com/auth/calendar |
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 LCA con las siguientes propiedades:
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
Propiedades obligatorias | |||
scope |
object |
En qué medida esta regla de LCA otorga acceso al calendario. | |
scope.type |
string |
El tipo de alcance. Los valores posibles son:
default ”, o público, se aplican a cualquier usuario, autenticado o no. |
|
Propiedades opcionales | |||
role |
string |
El rol asignado al permiso. Los valores posibles son:
|
admite escritura |
scope.value |
string |
La dirección de correo electrónico de un usuario o grupo, o el nombre de un dominio, según el tipo de permiso. Se omite para el tipo "default ". |
admite escritura |
Respuesta
Si se aplica correctamente, este método muestra un recurso LCA en el cuerpo de la respuesta.
Ejemplos
Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas cliente para consultar una lista de lenguajes admitidos).
Java
Usa la biblioteca cliente de Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.AclRule; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Retrieve the access rule from the API AclRule rule = service.acl().get('primary', "ruleId").execute(); // Make a change rule.setRole("newRole"); // Update the access rule AclRule updatedRule = service.acl().update('primary', rule.getId(), rule).execute(); System.out.println(updatedRule.getEtag());
Python
Utiliza la biblioteca cliente Python.
rule = service.acl().get(calendarId='primary', ruleId='ruleId').execute() rule['role'] = 'newRole' updated_rule = service.acl().update(calendarId='primary', ruleId=rule['id'], body=rule).execute() print updated_rule['etag']
PHP
Utiliza la biblioteca cliente de PHP.
$rule = $service->acl->get('primary', 'ruleId'); $rule->setRole('newRole'); $updatedRule = $service->acl->update('primary', $rule->getId(), $rule); echo $updatedRule->getEtag();
Rita
Utiliza la biblioteca cliente de Ruby.
rule = client.get_acl('primary', 'ruleId') rule.role = 'newRole' result = client.update_acl('primary', rule.id, rule) print result.etag
Pruébalo
Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.