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.
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 IDs de calendario, llama al método calendarList.list. Si deseas acceder al calendario principal del usuario que accedió 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 autorización con al menos uno de los siguientes permisos:
| Alcance |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.acls |
Para obtener más información, consulta la página autenticación y autorización.
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un recurso de ACL con las siguientes propiedades:
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
| Propiedades obligatorias |
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 ACL 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 ACL. |
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. |
|
| 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 alcance. Se omite para el tipo “default”. |
admite escritura
|
Respuesta
Si la respuesta es correcta, este método muestra un recurso de Acl en el cuerpo de la respuesta.
Pruébalo
Usa el Explorador de APIs que aparece a continuación para llamar a este método en datos en vivo y ver la respuesta.
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: insert\n\n| **Note:** Requires [authorization](#auth).\n\nCreates an access control rule.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|---------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n| **Optional query parameters** |||\n| `sendNotifications` | `boolean` | Whether to send notifications about the calendar sharing change. Optional. The default is True. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|-------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.acls` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Required Properties** ||||\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| **Optional Properties** ||||\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\nResponse\n--------\n\nIf successful, this method returns an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
