Settings

Les ressources représentent des paramètres que les utilisateurs peuvent modifier dans l'interface d'Agenda, comme leur fuseau horaire. Elles peuvent être récupérées via les méthodes list et get.Notez que si un paramètre a sa valeur par défaut, il risque de ne pas être renvoyé.

Liste des paramètres compatibles :

ID du paramètre Description Valeurs autorisées Valeur par défaut
autoAddHangouts Ajouter ou non automatiquement des Hangouts à tous les événements. Notez que ce paramètre est ignoré par le serveur si la valeur "conférenceDataVersion" est supérieure à 0, car le client est responsable de la gestion de 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 Permet d'afficher l'heure au format 24 heures. "true", "false" “false”
hideInvitations Indique s'il faut masquer les événements auxquels l'utilisateur est invité, mais n'a pas traité (par exemple, en répondant). "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", "tr", "vizhar", "TW", "TW", "CN", " "en"
remindOnRespondedEventsOnly Indique si des rappels d'événement doivent être envoyés uniquement pour les événements dont l'état de réponse de l'utilisateur est "Oui" et "Peut-être". "true", "false" “false”
showDeclinedEvents Indique si les événements auxquels l'utilisateur a répondu "Non" doivent être affichés dans son agenda. "true", "false" “true”
timezone 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 doit commencer 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 de 1 024 caractères au maximum.

Méthodes

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