Settings

Les ressources sont des paramètres que les utilisateurs peuvent modifier dans l'interface d'Agenda, comme le fuseau horaire de l'utilisateur. Ils peuvent être récupérés via les méthodes list et get.Notez que si un paramètre a sa valeur par défaut, il est possible qu'il ne soit pas renvoyé.

Voici la liste des paramètres compatibles:

ID du paramètre Description Valeurs autorisées Valeur par défaut
autoAddHangouts Permet d'ajouter automatiquement la visioconférence (Meet ou module complémentaire) à tous les événements. Notez que ce paramètre est ignoré par le serveur si la valeur "ferenceDataVersion" est supérieure à 0, car il incombe au client de gérer la logique en fonction de ce paramètre. Lecture seule. "true", "false" "false"
dateFieldOrder Ordre dans lequel le jour (D), le mois (M) et l'année (Y) doivent apparaître lorsque vous affichez des dates. "MDY", "DMY", "YMD" "MDY"
defaultEventLength Durée par défaut des événements (en minutes) créés sans durée explicite. nombre positif "60"
format24HourTime Indique si l'heure doit être affichée au format 24 heures. "true", "false" "false"
hideInvitations Indique si les événements auxquels l'utilisateur est invité, mais auxquels il n'a pas répondu (par exemple, en répondant) doivent être masqués. "true", "false" "false"
hideWeekends Indique si les week-ends doivent être masqués lorsque vous affichez une semaine. "true", "false" "false"
locale Paramètres régionaux de l'utilisateur. "in", "ca", "cs", "da", "de", "en_GB", "en", "es", "es_419", "tl", "fr", "hr", "it", "lv", "lt", "hu", "nl", "no", "pl", "pt_BR", "pt_PT", "ro", "sk", "sl", "fi", "sv", "rko", "vi", "z", "en"
remindOnRespondedEventsOnly Permet d'envoyer ou non des rappels d'événement uniquement pour les événements dont l'état de réponse de l'utilisateur est "Oui" et "Peut-être". "true", "false" "false"
showDeclinedEvents Permet d'afficher ou non les événements auxquels l'utilisateur a répondu "Non" dans son agenda. "true", "false" “true”
fuseau horaire ID du fuseau horaire de l'utilisateur. Consultez la page http://www.iana.org/time-zones. "Etc/GMT"
useKeyboardShortcuts Indique si les raccourcis clavier sont activés. "true", "false" “true”
weekStart Indique si la semaine commence le dimanche (0), le lundi (1) ou le samedi (6). "0", "1", "6" “0”

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#setting",
  "etag": etag,
  "id": string,
  "value": string
}
Nom de propriété Valeur Description Remarques
etag etag ETag de la ressource.
id string Identifiant du paramètre utilisateur.
kind string Type de la ressource ("calendar#setting").
value string Valeur du paramètre utilisateur. Le format de la valeur dépend de l'ID du paramètre. Il doit s'agir d'une chaîne UTF-8 d'une longueur maximale de 1 024 caractères.

Méthodes

get
Renvoie un paramètre pour un seul utilisateur.
liste
Renvoie tous les paramètres utilisateur de l'utilisateur authentifié.
montre
Surveillez les modifications apportées aux ressources des paramètres.