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