Tiện ích bổ sung của Google Workspace có thể truy cập vào ngôn ngữ và múi giờ của người dùng và sử dụng thông tin đó để tuỳ chỉnh giao diện và hành vi. Bạn phải định cấu hình tệp kê khai của tiện ích bổ sung để cho phép tiện ích bổ sung của bạn truy cập thông tin này.
Định cấu hình tệp kê khai tiện ích bổ sung
Bạn có thể định cấu hình tiện ích bổ sung để truy cập vào ngôn ngữ của người dùng và thông tin múi giờ bằng cách làm theo các bước sau:
- Trong tệp kê khai của tiện ích bổ sung
tệp, đặt giá trị
addOns.common.useLocaleFromAppsangtrue. - Nếu chưa có, hãy thêm phạm vi rõ ràng sau đây vào
oauthScopescủa tệp kê khai danh sách:https://www.googleapis.com/auth/script.locale
Nếu bạn đã thêm một phạm vi vào danh sách oauthScope của tiện ích bổ sung,
người dùng phải uỷ quyền lại
tiện ích bổ sung
vào lần mở cửa tiếp theo.
Nhận thông tin về ngôn ngữ và múi giờ
Đối tượng sự kiện
mang thông tin ngôn ngữ của người dùng khi được định cấu hình đúng. Các trường sau đây
xuất hiện trong commonEventObject
cấu trúc con của đối tượng sự kiện:
commonEventObject.userLocale– Ngôn ngữ và quốc gia/khu vực của người dùng giá trị nhận dạng. Ví dụ:en-US.commonEventObject.timeZone.offset—Độ lệch múi giờ của người dùng, theo mili giây so với Giờ phối hợp quốc tế (UTC).commonEventObject.timeZone.id– Giá trị nhận dạng múi giờ của người dùng. Ví dụ:America/New_York.commonEventObject.timeZone– Mã múi giờ và độ lệch của người dùng.
Xem phần Đối tượng sự kiện để biết thêm chi tiết.
Đối tượng sự kiện được chuyển đến hàm gọi lại hành động khi người dùng tương tác với tiện ích bổ sung và với trang chủ và theo bối cảnh hàm kích hoạt. Mỗi hàm callback hoặc kích hoạt đều có thể đọc thông tin về ngôn ngữ và múi giờ từ đối tượng sự kiện, đồng thời sử dụng thông tin này nếu cần. Ví dụ: một hàm callback di chuyển đến thẻ mới có thể tham chiếu đến chuỗi ngôn ngữ khi quyết định văn bản nào cần thêm vào thẻ.