קבלת הלוקאל ואזור הזמן של משתמש בתוסף Google Workspace

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

הגדרה של משאב הפריסה של התוסף

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

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

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

קבלת פרטים על מקום ואזור זמן

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

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

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