Acl
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para ver uma lista de métodos desse recurso, consulte o final desta página.
Representações de recursos
{
"kind": "calendar#aclRule",
"etag": etag,
"id": string,
"scope": {
"type": string,
"value": string
},
"role": string
}
Nome da propriedade |
Valor |
Descrição |
Observações |
etag |
etag |
ETag do recurso. |
|
id |
string |
Identificador da regra da lista de controle de acesso (ACL). Consulte Compartilhar agendas. |
|
kind |
string |
Tipo do recurso ("calendar#aclRule "). |
|
role |
string |
O papel atribuído ao escopo. Os valores possíveis são: - "
none ": não oferece acesso. - "
freeBusyReader ": fornece acesso de leitura às informações de disponibilidade/inisponibilidade. - "
reader ": fornece acesso de leitura à agenda. Os eventos particulares vão aparecer para os usuários com acesso de leitor, mas os detalhes do evento vão ficar ocultos. - "
writer ": concede acesso de leitura e gravação à agenda. Os eventos particulares vão aparecer para usuários com acesso de gravação, e os detalhes do evento vão estar visíveis. Dá acesso de leitura às ACLs da agenda. - "
owner ": fornece a propriedade da agenda. Esse papel tem todas as permissões do papel de redator, além da capacidade de manipular ACLs. |
gravável
|
scope |
object |
O nível em que o acesso à agenda é concedido por essa regra de ACL. |
|
scope.type |
string |
O tipo de escopo. Os valores possíveis são: - "
default ": o escopo público. Esse é o valor padrão. - "
user ": limita o escopo a um único usuário. - "
group ": limita o escopo a um grupo. - "
domain ": limita o escopo a um domínio. Observação: as permissões concedidas ao escopo "default ", ou público, se aplicam a qualquer usuário, autenticado ou não. |
|
scope.value |
string |
O endereço de e-mail de um usuário ou grupo ou o nome de um domínio, dependendo do tipo de escopo. Omitido para o tipo "default ". |
gravável
|
Métodos
- delete
- Exclui uma regra de controle de acesso.
- get
- Retorna uma regra de controle de acesso.
- inserir
- Cria uma regra de controle de acesso.
- list
- Retorna as regras na lista de controle de acesso da agenda.
- patch
- Atualiza uma regra de controle de acesso. Esse método é compatível com a semântica de patch. Cada solicitação de patch consome três unidades de cota. Use um
get
seguido de um update
. Os valores de campo especificados substituem os valores atuais. Os campos que você não especificar na solicitação permanecem inalterados. Os campos de matriz, se especificados, substituem as matrizes atuais. Isso descarta todos os elementos de matriz anteriores.
- update
- Atualiza uma regra de controle de acesso.
- watch
- Observe as mudanças nos recursos da ACL.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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."]]