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 del calendario. Para recuperar los ID de calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario actual, usa la palabra clave “primary ”.
|
ruleId |
string |
Es el identificador de la regla de LCA. |
Parámetros de consulta opcionales | ||
sendNotifications |
boolean |
Indica si se deben enviar notificaciones sobre el cambio en el uso compartido del calendario. Tenga 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:
Permiso |
---|
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 |
La medida en la que 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 ejecuta de forma correcta, 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
Usa la biblioteca cliente de 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
Usa 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();
Ruby
Usa la biblioteca cliente Ruby.
rule = client.get_acl('primary', 'ruleId') rule.role = 'newRole' result = client.update_acl('primary', rule.id, rule) print result.etag
Pruébala
Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en tiempo real y ver la respuesta.