Acl: insert

Crée une règle de contrôle des accès. Essayer maintenant.

Requête

Requête HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
calendarId string Identifiant de l'agenda. Pour récupérer les ID d'agenda, appelez la méthode calendarList.list. Si vous souhaitez accéder à l'agenda principal de l'utilisateur actuellement connecté, utilisez le mot clé "primary".
Paramètres de requête (facultatifs)
sendNotifications boolean Indique s'il faut envoyer des notifications concernant la modification du partage de l'agenda. Facultatif. La valeur par défaut est "True".

Autorisation

Cette requête nécessite une autorisation avec au moins l'un des champs d'application suivants :

Champ d'application
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Dans le corps de la requête, indiquez une ressource Acl avec les propriétés suivantes :

Nom de propriété Valeur Description Remarques
Propriétés obligatoires
role string Rôle attribué au champ d'application. Valeurs possibles :
  • "none" : aucun accès.
  • "freeBusyReader" : accès en lecture aux informations sur les disponibilités.
  • "reader" : accès en lecture à l'agenda. Les événements privés s'affichent pour les utilisateurs ayant un accès en lecture, mais les détails de l'événement sont masqués.
  • "writerWithoutPrivateAccess" : accès en lecture et en écriture à l'agenda. Les événements privés s'affichent pour les utilisateurs ayant un accès writerWithoutPrivateAccess, mais les détails de l'événement sont masqués.
  • "writer" : accès en lecture et en écriture à l'agenda. Les événements privés s'affichent pour les utilisateurs ayant un accès en écriture, et les détails de l'événement sont visibles. Accès en lecture aux LCA de l'agenda.
  • "owner" : accès administrateur à l'agenda. Ce rôle dispose de toutes les autorisations du rôle "writer" et peut en plus modifier les niveaux d'accès des autres utilisateurs.

accessible en écriture
scope object Mesure dans laquelle l'accès à l'agenda est accordé par cette règle de LCA.
scope.type string Type de champ d'application. Valeurs possibles :
  • "default" : champ d'application public. 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" (public) s'appliquent à tous les utilisateurs, qu'ils soient authentifiés ou non.
Propriétés facultatives
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

Réponse

En cas de succès, cette méthode renvoie une ressource Acl dans le corps de la réponse.

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.