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 |
Identificador de calendario. Para recuperar los ID de calendario, llama al método calendarList.list. Si deseas ver el calendario principal del usuario que tiene acceso actualmente, usa la palabra clave "primary ".
|
Parámetros de consulta opcionales | ||
sendNotifications |
boolean |
Si se deben enviar notificaciones sobre el cambio de uso compartido del calendario. 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 de LCA con las siguientes propiedades:
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
Propiedades obligatorias | |||
role |
string |
La función asignada al permiso. Los valores posibles son:
|
admite escritura |
scope |
object |
En qué medida se otorga acceso al calendario mediante esta regla de LCA. | |
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 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(); // 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 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 de Ruby.
rule = Google::Apis::CalendarV3::AclRule.new( scope: { type: 'scopeType', value: 'scopeEmail', }, role: 'role' ) result = client.insert_acl('primary', rule) print result.id
Pruébela.
Usa el Explorador de API que aparece a continuación para llamar a este método en datos en vivo y ver la respuesta.