Obtenir les paramètres régionaux et le fuseau horaire de l'utilisateur
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les modules complémentaires Google Workspace peuvent accéder aux paramètres régionaux et au fuseau horaire de leur utilisateur, et utiliser ces informations pour personnaliser leur interface et leur comportement. Vous devez configurer le fichier manifeste de votre module complémentaire pour lui permettre d'accéder à ces informations.
Configurer le fichier manifeste du module complémentaire
Vous pouvez configurer votre module complémentaire pour qu'il accède aux informations sur les paramètres régionaux et le fuseau horaire de l'utilisateur en procédant comme suit:
Dans le fichier fichier manifeste de votre module complémentaire, définissez le champ addOns.common.useLocaleFromApp sur true.
Si ce n'est pas déjà fait, ajoutez le champ d'application explicite suivant dans la liste oauthScopes du fichier manifeste :
https://www.googleapis.com/auth/script.locale
Si vous avez ajouté un champ d'application à la liste oauthScope du module complémentaire, les utilisateurs doivent réautoriser le module complémentaire la prochaine fois qu'il sera ouvert.
Obtenir des informations sur les paramètres régionaux et le fuseau horaire
Les objets d'événement contiennent des informations sur les paramètres régionaux de l'utilisateur lorsqu'ils sont correctement configurés. Les champs suivants apparaissent dans la sous-structure commonEventObject de l'objet événement:
commonEventObject.userLocale : identifiant de la langue et du pays/région de l'utilisateur. Exemple :en-US
commonEventObject.timeZone.offset : décalage du fuseau horaire de l'utilisateur, en millisecondes, par rapport au temps universel coordonné (UTC).
commonEventObject.timeZone.id : identifiant du fuseau horaire de l'utilisateur.
Exemple :America/New_York
commonEventObject.timeZone : ID et décalage du fuseau horaire de l'utilisateur.
Les objets d'événement sont transmis aux fonctions de rappel d'action lorsque l'utilisateur interagit avec votre module complémentaire, ainsi qu'aux fonctions de déclencheur de la page d'accueil et de contexte. Chaque fonction de rappel ou de déclencheur peut lire les informations sur les paramètres régionaux et le fuseau horaire de l'objet d'événement et les utiliser si nécessaire.
Par exemple, une fonction de rappel qui accède à une nouvelle fiche peut se référer à la chaîne de paramètres régionaux pour déterminer le texte à ajouter à la fiche.
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 2024/12/22 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/12/22 (UTC)."],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],["Google Workspace add-ons can access user locale and timezone by configuring the add-on manifest. Set `addOns.common.useLocaleFromApp` to `true` and add `https://www.googleapis.com/auth/script.locale` to `oauthScopes`. This requires users to re-authorize the add-on. Event objects contain `userLocale`, `timeZone.offset`, and `timeZone.id`. Callback functions and trigger functions read this information from the event object to customize the add-on's interface and behavior, such as text on cards.\n"]]
