Acl: insert

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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:
  • "none": No proporciona acceso.
  • "freeBusyReader": Proporciona acceso de lectura a información de disponible/ocupado.
  • "reader": Proporciona acceso de lectura al calendario. Los eventos privados se mostrarán a los usuarios con acceso de lectura, pero los detalles de los eventos estarán ocultos.
  • "writer": Proporciona acceso de lectura y escritura al calendario. Los eventos privados se mostrarán a los usuarios con acceso de escritor, y los detalles de los eventos estarán visibles.
  • "owner": Proporciona la propiedad del calendario. Esta función tiene todos los permisos de la función de escritor, además de la capacidad adicional de ver y manipular las LCA.
 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": 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 de "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.