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

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

תוספים של 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) כשהיא מחליטה איזה טקסט להוסיף לכרטיס.