הצגת המיקום ואזור הזמן של המשתמש

לתוספים ל-Google Workspace יש גישה לאזור ולאזור הזמן של המשתמש ולשימוש בהם כדי להתאים אישית את הממשק וההתנהגות שלו. עליך להגדיר המניפסט של התוסף כדי לאפשר לתוסף לגשת מידע זה.

הגדרת המניפסט של התוסף

אפשר להגדיר לתוסף גישה ללוקאל של המשתמש מידע על אזור הזמן באמצעות השלבים הבאים:

1. במניפסט של התוסף קובץ, הגדירו addOns.common.useLocaleFromApp לשדה true.
2. אם היקף ההרשאות המפורש הבא לא נמצא עדיין, oauthScopes של המניפסט list: https://www.googleapis.com/auth/script.locale

אם הוספתם היקף לרשימת oauthScope של התוסף, משתמשים חייבים לאשר מחדש את בפעם הבאה שפותחים אותו.

קבלת מידע על המיקום ואזור הזמן

אובייקטים של אירועים להעביר מידע על הלוקאל של המשתמש כשהוא מוגדר כראוי. השדות הבאים מופיעות בcommonEventObject של אובייקט האירוע:

• commonEventObject.userLocale – השפה והמדינה/האזור של המשתמש למזהה נתון. לדוגמה, en-US.
• commonEventObject.timeZone.offset – היסט אזור הזמן של המשתמש, ב אלפיות שנייה, מזמן אוניברסלי מתואם (UTC).
• commonEventObject.timeZone.id – מזהה אזור הזמן של המשתמש. לדוגמה, America/New_York.
• commonEventObject.timeZone – מזהה אזור הזמן של המשתמש והיסט.

צפייה בקטע אובייקטים של אירועים אפשר לקבל פרטים נוספים.

אובייקטים של אירועים מועברים אל פונקציות קריאה חוזרת לפעולה בזמן שהמשתמש יוצר אינטראקציה עם התוסף שלך ועם דף הבית ובהקשר של הטריגרים. כל פונקציית קריאה חוזרת או טריגר (callback) יכולה לקרוא את את פרטי המיקום ואזור הזמן מאובייקט האירוע ומשתמשים בהם לפי הצורך. לדוגמה, פונקציית קריאה חוזרת מעבר לכרטיס חדש יכולים להתייחס למחרוזת הלוקאל כשמחליטים איזה טקסט להוסיף לכרטיס.