คู่มือนี้อธิบายวิธีที่ส่วนเสริมจะทราบภาษาและเขตเวลาของผู้ใช้ แล้วนำข้อมูลดังกล่าวไปใช้ในการปรับแต่งอินเทอร์เฟซและลักษณะการทำงานของส่วนเสริม โปรดดูคู่มือเฉพาะของ Google Apps Script ที่หัวข้อรับข้อมูลภาษาและเขตเวลาของผู้ใช้ในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Apps Script
กำหนดค่าทรัพยากรการทำให้ใช้งานได้ของส่วนเสริม
หากต้องการอนุญาตให้ส่วนเสริมรับข้อมูลภาษาและเขตเวลาของผู้ใช้ ให้กำหนดค่าทรัพยากรการทำให้ใช้งานได้ของส่วนเสริม ดังนี้
- ในทรัพยากรการติดตั้งใช้งานของส่วนเสริม ให้ตั้งค่าช่อง
addOns.common.useLocaleFromApp
เป็นtrue
- เพิ่มขอบเขตการให้สิทธิ์
https://www.googleapis.com/auth/script.locale
ลงในรายการoauthScopes
ของทรัพยากรการทำให้ใช้งานได้ ขอบเขตนี้ให้สิทธิ์ส่วนเสริมแก่ผู้ใช้ในการดูประเทศ ภาษา และเขตเวลา - บันทึกทรัพยากรการทำให้ใช้งานได้ที่อัปเดต
หลังจากเพิ่มขอบเขตลงในรายการ oauthScopes
ของส่วนเสริมแล้ว ผู้ใช้ต้องให้สิทธิ์ส่วนเสริมอีกครั้งเมื่อใช้ส่วนเสริมในครั้งถัดไป
ดูข้อมูลภาษาและเขตเวลา
ออบเจ็กต์เหตุการณ์มีข้อมูลภาษาของผู้ใช้ ซึ่งคุณจะหาได้จากพร็อพเพอร์ตี้ commonEventObject
ต่อไปนี้
commonEventObject.userLocale
- ตัวระบุภาษาและประเทศหรือภูมิภาคของผู้ใช้ ตัวอย่างเช่นen-US
จะแสดงถึงภาษาอังกฤษที่พูดในสหรัฐอเมริกาcommonEventObject.timeZone.offset
- ออฟเซ็ตเขตเวลาของผู้ใช้ในหน่วยมิลลิวินาทีจากเวลาสากลเชิงพิกัด (UTC)commonEventObject.timeZone.id
- ตัวระบุเขตเวลาของผู้ใช้ ตัวอย่างเช่นAmerica/New_York
commonEventObject.timeZone
- รหัสเขตเวลาและออฟเซ็ตของผู้ใช้
ออบเจ็กต์เหตุการณ์
จะส่งไปยังฟังก์ชันเรียกกลับของ action
,
homepageTrigger
และ
contextualTrigger
ฟังก์ชันเมื่อผู้ใช้โต้ตอบกับส่วนเสริม เช่น
การคลิกปุ่ม ฟังก์ชันเรียกกลับหรือทริกเกอร์แต่ละรายการจะได้รับข้อมูลภาษาและเขตเวลาจากออบเจ็กต์เหตุการณ์และนำไปใช้ตามที่จำเป็นได้ เช่น ฟังก์ชันเรียกกลับที่ไปยังการ์ดใหม่อาจหมายถึงสตริงภาษาเมื่อตัดสินใจว่าจะเพิ่มข้อความใดลงในการ์ด