Acl
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Para obtener una lista de los métodos de este recurso, consulta el final de esta página.
Representaciones de recursos
{
"kind": "calendar#aclRule",
"etag": etag,
"id": string,
"scope": {
"type": string,
"value": string
},
"role": string
}
Nombre de la propiedad |
Valor |
Descripción |
Notas |
etag |
etag |
ETag del recurso. |
|
id |
string |
Es el identificador de la regla de la lista de control de acceso (LCA). Consulta Cómo compartir calendarios. |
|
kind |
string |
Es el tipo de recurso ("calendar#aclRule "). |
|
role |
string |
Es el rol asignado al alcance. Los valores posibles son los siguientes: - "
none ": No proporciona acceso. - "
freeBusyReader ": Proporciona acceso de lectura a la información de disponibilidad. - "
reader ": Proporciona acceso de lectura al calendario. Los eventos privados aparecerán para los usuarios con acceso de lectura, pero se ocultarán los detalles. - "
writer ": Otorga acceso de lectura y escritura al calendario. Los eventos privados aparecerán para los usuarios con acceso de escritor, y se podrán ver sus detalles. Proporciona acceso de lectura a las LCA del calendario. - "
owner ": Proporciona la propiedad del calendario. Este rol tiene todos los permisos del rol de escritor con la capacidad adicional de manipular las LCA. |
admite escritura
|
scope |
object |
El grado en que esta regla de LCA otorga acceso al calendario |
|
scope.type |
string |
Es el tipo de alcance. Los valores posibles son los siguientes: - "
default ": Es el alcance público. Este es el valor predeterminado. - "
user ": Limita el permiso a un solo usuario. - "
group ": Limita el permiso a un grupo. - "
domain ": Limita el permiso a un dominio. Nota: Los permisos otorgados al permiso "default ", o público, se aplican a cualquier usuario, ya sea autenticado o no. |
|
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 alcance. Se omite para el tipo “default ”. |
admite escritura
|
Métodos
- borrar
- Borra una regla de control de acceso.
- get
- Devuelve una regla de control de acceso.
- insertar
- Crea una regla de control de acceso.
- list
- Devuelve las reglas de la lista de control de acceso del calendario.
- patch
- Actualiza una regla de control de acceso. Este método es compatible con la semántica de parches. Ten en cuenta que cada solicitud de parche consume tres unidades de cuota. Te recomendamos que uses un
get
seguido de un update
. Los valores de campo que especifiques reemplazarán los valores existentes. Los campos que no especifiques en la solicitud no se modificarán. Si se especifican, los campos de array reemplazan los arrays existentes, lo que descarta cualquier elemento de array anterior.
- actualizar
- Actualiza una regla de control de acceso.
- mirar
- Presta atención a los cambios en los recursos de LCA.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],null,["# Acl\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```carbon\n{\n \"kind\": \"calendar#aclRule\",\n \"etag\": etag,\n \"id\": string,\n \"scope\": {\n \"type\": string,\n \"value\": string\n },\n \"role\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the Access Control List (ACL) rule. See [Sharing calendars](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars). | |\n| `kind` | `string` | Type of the resource (\"`calendar#aclRule`\"). | |\n| `role` | `string` | The role assigned to the scope. Possible values are: - \"`none`\" - Provides no access. - \"`freeBusyReader`\" - Provides read access to free/busy information. - \"`reader`\" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - \"`writer`\" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. Provides read access to the calendar's ACLs. - \"`owner`\" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to manipulate ACLs. | writable |\n| `scope` | `object` | The extent to which [calendar access](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars) is granted by this ACL rule. | |\n| scope.`type` | `string` | The type of the scope. Possible values are: - \"`default`\" - The public scope. This is the default value. - \"`user`\" - Limits the scope to a single user. - \"`group`\" - Limits the scope to a group. - \"`domain`\" - Limits the scope to a domain. Note: The permissions granted to the \"`default`\", or public, scope apply to any user, authenticated or not. | |\n| scope.`value` | `string` | The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type \"`default`\". | writable |\n\nMethods\n-------\n\n[delete](/workspace/calendar/api/v3/reference/acl/delete)\n: Deletes an access control rule.\n\n[get](/workspace/calendar/api/v3/reference/acl/get)\n: Returns an access control rule.\n\n[insert](/workspace/calendar/api/v3/reference/acl/insert)\n: Creates an access control rule.\n\n[list](/workspace/calendar/api/v3/reference/acl/list)\n: Returns the rules in the access control list for the calendar.\n\n[patch](/workspace/calendar/api/v3/reference/acl/patch)\n: Updates an access control rule. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/acl/update)\n: Updates an access control rule.\n\n[watch](/workspace/calendar/api/v3/reference/acl/watch)\n: Watch for changes to ACL resources."]]