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

ส่วนเสริมสามารถเข้าถึงภาษาและเขตเวลาของผู้ใช้ และใช้ข้อมูลดังกล่าวเพื่อปรับแต่งอินเทอร์เฟซและการทำงาน คุณต้องกำหนดค่าไฟล์ 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 - รหัสเขตเวลาและออฟเซ็ตของผู้ใช้

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

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