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 ou non automatiquement Hangouts à 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 Quel doit être l'ordre du jour (J), du mois (M) et de l'année (Y) lors de l'affichage des dates ? "MDY", "DMY", "YMD" "MDY"
defaultEventLength Durée par défaut (en minutes) des événements 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 Permet de masquer les événements auxquels l'utilisateur est invité, mais qui n'a pas agi (en répondant, par exemple). "true", "false" "false"
hideWeekends Indique si les week-ends doivent être masqués lors de l'affichage d'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", "rkoar", "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 toujours s'agir d'une chaîne UTF-8 d'une longueur maximale de 1 024 caractères.

Méthodes

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