Obtenir les paramètres régionaux et le fuseau horaire de l'utilisateur

Les modules complémentaires Google Workspace peuvent accéder aux paramètres régionaux et au fuseau horaire de leurs utilisateurs, et les utiliser ces informations pour personnaliser son interface et son comportement. Vous devez configurer le fichier manifeste du module complémentaire ; pour autoriser votre module complémentaire à accéder ces informations.

Configurer le fichier manifeste du module complémentaire

Vous pouvez configurer votre module complémentaire pour accéder aux paramètres régionaux de l'utilisateur et informations de fuseau horaire en procédant comme suit:

1. Dans le fichier manifeste du module complémentaire , définissez le paramètre addOns.common.useLocaleFromApp sur true.
2. S'il n'est pas déjà présent, ajoutez le champ d'application explicite suivant dans oauthScopes du fichier manifeste liste: 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 autoriser à nouveau le module complémentaire à la prochaine ouverture.

Remarque :Si votre module complémentaire utilisait auparavant API Calendar, la Service Agenda Apps Script ou un autre service pour accéder aux paramètres régionaux et au fuseau horaire de l'utilisateur, demandez-vous est toujours nécessaire à votre module complémentaire. Si ce n'est pas le cas, supprimez les champs d'application requis par le service fichier manifeste. Limitez toujours votre liste de champs d'application aux services que votre besoins complémentaires.

Obtenir des informations sur les paramètres régionaux et le fuseau horaire

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 commonEventObject sous-structure de l'objet événement:

• commonEventObject.userLocale : langue et pays/région de l'utilisateur identifiant. Exemple :en-US
• commonEventObject.timeZone.offset : décalage horaire de l'utilisateur, dans millisecondes, à partir du temps universel coordonné (UTC).
• commonEventObject.timeZone.id : identifiant de fuseau horaire de l'utilisateur. Exemple :America/New_York
• commonEventObject.timeZone : ID du fuseau horaire et décalage de l'utilisateur.

Voir Objets "Événement" pour en savoir plus.

Les objets d'événement sont transmis fonctions de rappel d'action lorsque l'utilisateur interagit avec votre module complémentaire, et vers la page d'accueil et contextuelles les fonctions de déclenchement. Chaque fonction de rappel ou de déclencheur peut lire les paramètres régionaux et le fuseau horaire de l'objet événement, et utilisez-les si nécessaire. Par exemple, une fonction de rappel accéder à une nouvelle carte pourrait faire référence à la chaîne des paramètres régionaux pour décider quel texte ajouter à la fiche.