ดูภาษาและเขตเวลาของผู้ใช้

ส่วนเสริม Google Workspace สามารถเข้าถึงภาษาและเขตเวลาของผู้ใช้ และใช้ข้อมูลดังกล่าวเพื่อปรับแต่งอินเทอร์เฟซและลักษณะการทำงาน คุณต้องกำหนดค่าไฟล์ Manifest ของส่วนเสริมเพื่ออนุญาตให้เข้าถึงข้อมูลนี้ได้

กำหนดค่าไฟล์ Manifest ของส่วนเสริม

คุณกำหนดค่าส่วนเสริมให้เข้าถึงข้อมูลภาษาและเขตเวลาของผู้ใช้ได้โดยทำตามขั้นตอนต่อไปนี้

1. ในไฟล์ Manifest ของส่วนเสริม ให้ตั้งค่าช่อง addOns.common.useLocaleFromApp เป็น true
2. หากยังไม่มี ให้เพิ่มขอบเขตที่ชัดเจนต่อไปนี้ในoauthScopesรายการของไฟล์ Manifest https://www.googleapis.com/auth/script.locale

หากคุณเพิ่มขอบเขตลงในรายการ oauthScope ของส่วนเสริม ผู้ใช้จะต้องให้สิทธิ์อีกครั้งเมื่อเปิดส่วนเสริมครั้งถัดไป

หมายเหตุ: หากก่อนหน้านี้ส่วนเสริมใช้ Calendar API, บริการปฏิทินของ Apps Script หรือบริการอื่นๆ เพื่อเข้าถึงภาษาและเขตเวลาของผู้ใช้ ให้พิจารณาว่าส่วนเสริมยังต้องใช้บริการดังกล่าวอยู่หรือไม่ หากไม่ ให้นําขอบเขตที่บริการจําเป็นออกจากไฟล์ Manifest จำกัดรายการขอบเขตไว้เฉพาะบริการที่ส่วนเสริมของคุณต้องใช้

รับข้อมูลภาษาและเขตเวลา

ออบเจ็กต์เหตุการณ์จะนําข้อมูลภาษาของผู้ใช้เมื่อกําหนดค่าอย่างถูกต้อง ฟิลด์ต่อไปนี้จะปรากฏในโครงสร้างย่อย commonEventObject ของออบเจ็กต์เหตุการณ์

• commonEventObject.userLocale - ตัวระบุภาษาและประเทศ/ภูมิภาคของผู้ใช้ เช่น en-US
• commonEventObject.timeZone.offset - เขตเวลาของผู้ใช้ที่ลบล้างจากเวลาสากลเชิงพิกัด (UTC) เป็นมิลลิวินาที
• commonEventObject.timeZone.id - ตัวระบุเขตเวลาของผู้ใช้ เช่น America/New_York
• commonEventObject.timeZone - รหัสและค่าออฟเซ็ตของเขตเวลาของผู้ใช้

ดูรายละเอียดเพิ่มเติมได้ที่ออบเจ็กต์เหตุการณ์

ระบบจะส่งออบเจ็กต์เหตุการณ์ไปยังฟังก์ชันการเรียกกลับการดำเนินการเมื่อผู้ใช้โต้ตอบกับส่วนเสริม รวมถึงไปยังฟังก์ชันทริกเกอร์ของหน้าแรกและตามบริบท ฟังก์ชันการเรียกกลับหรือทริกเกอร์แต่ละรายการจะอ่านข้อมูลภาษาและเขตเวลาจากออบเจ็กต์เหตุการณ์ และใช้ข้อมูลดังกล่าวได้ตามต้องการ เช่น ฟังก์ชันการเรียกกลับที่ไปยังการ์ดใหม่อาจอ้างอิงสตริงภาษาเมื่อตัดสินใจว่าจะเพิ่มข้อความใดลงในการ์ด