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

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

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

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

1. בקובץ manifest של התוסף, מגדירים את השדה addOns.common.useLocaleFromApp לערך true.
2. אם הוא לא מופיע, מוסיפים את ההיקף הבא ברשימה oauthScopes של המניפסט: 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) של פעולות כשהמשתמש יוצר אינטראקציה עם התוסף, ולפונקציות של דף הבית ושל טריגרים לפי הקשר. כל פונקציית קריאה חוזרת או פונקציית טריגר יכולה לקרוא את המידע על אזור הזמן והשפה מאובייקט האירוע ולהשתמש בו לפי הצורך. לדוגמה, פונקציית קריאה חוזרת (callback) שמבצעת ניווט לכרטיס חדש יכולה להפנות למחרוזת האזור (locale) כשהיא מחליטה איזה טקסט להוסיף לכרטיס.