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

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

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

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

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

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

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

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

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

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

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