การเข้าถึงภาษาและเขตเวลาของผู้ใช้

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

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

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

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

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

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

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

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

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

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