Crea una regla de control de acceso. Pruébalo ahora y ve un ejemplo.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl
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 ”.
|
Parámetros de consulta opcionales | ||
sendNotifications |
boolean |
Indica si se deben enviar notificaciones sobre el cambio en el uso compartido del calendario. 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 | |||
role |
string |
El rol asignado al permiso. Los valores posibles son:
|
admite escritura |
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 | |||
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(); // Create access rule with associated scope AclRule rule = new AclRule(); Scope scope = new Scope(); scope.setType("scopeType").setValue("scopeValue"); rule.setScope(scope).setRole("role"); // Insert new access rule AclRule createdRule = service.acl().insert('primary', rule).execute(); System.out.println(createdRule.getId());
Python
Usa la biblioteca cliente de Python.
rule = { 'scope': { 'type': 'scopeType', 'value': 'scopeEmail', }, 'role': 'role' } created_rule = service.acl().insert(calendarId='primary', body=rule).execute() print created_rule['id']
PHP
Usa la biblioteca cliente de PHP.
$rule = new Google_Service_Calendar_AclRule(); $scope = new Google_Service_Calendar_AclRuleScope(); $scope->setType("scopeType"); $scope->setValue("scopeValue"); $rule->setScope($scope); $rule->setRole("role"); $createdRule = $service->acl->insert('primary', $rule); echo $createdRule->getId();
Ruby
Usa la biblioteca cliente Ruby.
rule = Google::Apis::CalendarV3::AclRule.new( scope: { type: 'scopeType', value: 'scopeEmail', }, role: 'role' ) result = client.insert_acl('primary', rule) print result.id
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.