Acl
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
{
"kind": "calendar#aclRule",
"etag": etag,
"id": string,
"scope": {
"type": string,
"value": string
},
"role": string
}
| Nom de propriété |
Valeur |
Description |
Remarques |
etag |
etag |
ETag de la ressource. |
|
id |
string |
Identifiant de la règle de la liste de contrôle d'accès (LCA). Consultez Partager des agendas. |
|
kind |
string |
Type de la ressource ("calendar#aclRule"). |
|
role |
string |
Rôle attribué au champ d'application. Les valeurs possibles sont les suivantes: - "
none" : n'accorde aucun accès. - "
freeBusyReader" : permet d'accéder en lecture aux informations de disponibilité. - "
reader" : permet d'accéder en lecture à l'agenda. Les événements privés s'affichent pour les utilisateurs disposant d'un accès lecteur, mais les détails de l'événement sont masqués. - "
writer" : permet d'accéder en lecture et en écriture à l'agenda. Les événements privés s'affichent pour les utilisateurs disposant d'un accès en tant qu'auteur, et leurs détails sont visibles. Fournit un accès en lecture aux ACL de l'agenda. - "
owner" : indique le propriétaire de l'agenda. Ce rôle dispose de toutes les autorisations du rôle d'auteur, avec la possibilité supplémentaire de manipuler les LCA. |
accessible en écriture
|
scope |
object |
Niveau d'accès à l'agenda accordé par cette règle de LCA. |
|
scope.type |
string |
Type de champ d'application. Les valeurs possibles sont les suivantes: - "
default" : portée publique. Il s'agit de la valeur par défaut. - "
user" : limite le champ d'application à un seul utilisateur. - "
group" : limite le champ d'application à un groupe. - "
domain" : limite le champ d'application à un domaine. Remarque: Les autorisations accordées au champ d'application "default", ou public, s'appliquent à tous les utilisateurs, qu'ils soient authentifiés ou non. |
|
scope.value |
string |
Adresse e-mail d'un utilisateur ou d'un groupe, ou nom d'un domaine, selon le type de champ d'application. omis pour le type "default". |
accessible en écriture
|
Méthodes
- supprimer
- Supprime une règle de contrôle des accès.
- get
- Renvoie une règle de contrôle des accès.
- insérer
- Crée une règle de contrôle d'accès.
- liste
- Renvoie les règles de la liste de contrôle d'accès de l'agenda.
- patch
- Met à jour une règle de contrôle des accès. Cette méthode est compatible avec la sémantique "patch". Notez que chaque requête de correctif consomme trois unités de quota. Nous vous recommandons d'utiliser un
get suivi d'un update. Les valeurs de champ que vous spécifiez remplacent les valeurs existantes. Les champs que vous ne spécifiez pas dans la requête restent inchangés. Si spécifiés, les champs de tableau écrasent les tableaux existants. Tous les éléments de tableau précédents sont alors supprimés.
- update
- Met à jour une règle de contrôle des accès.
- montre
- Surveillez les modifications apportées aux ressources de LCA.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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."]]
