รับข้อมูลภาษาและเขตเวลาสำหรับผู้ใช้ส่วนเสริมของ Google Workspace

คู่มือนี้อธิบายวิธีที่ส่วนเสริมจะทราบภาษาและเขตเวลาของผู้ใช้ แล้วนำข้อมูลดังกล่าวไปใช้ในการปรับแต่งอินเทอร์เฟซและลักษณะการทำงานของส่วนเสริม โปรดดูคู่มือเฉพาะของ Google Apps Script ที่หัวข้อรับข้อมูลภาษาและเขตเวลาของผู้ใช้ในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Apps Script

กำหนดค่าทรัพยากรการทำให้ใช้งานได้ของส่วนเสริม

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

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

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

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

ออบเจ็กต์เหตุการณ์มีข้อมูลภาษาของผู้ใช้ ซึ่งคุณจะหาได้จากพร็อพเพอร์ตี้ commonEventObject ต่อไปนี้

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

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