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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

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