Tiện ích bổ sung có thể truy cập ngôn ngữ và múi giờ của người dùng, cũng như sử dụng thông tin đó để tuỳ chỉnh giao diện và hành vi của tiện ích. 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 truy cập vào 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 thông tin về ngôn ngữ và múi giờ của người dùng theo các bước sau:
- Trong tệp tệp kê khai của tiện ích bổ sung, hãy đặt trường
addOns.common.useLocaleFromAppthànhtrue. - Nếu chưa có phạm vi rõ ràng này, hãy thêm phạm vi rõ ràng sau vào danh sách
oauthScopescủa tệp kê khai:https://www.googleapis.com/auth/script.locale - Lưu các thay đổi đối với tệp kê khai.
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ở 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ách. Các trường sau đây sẽ xuất hiện trong cấu trúc con commonEventObject của đối tượng sự kiện:
commonEventObject.userLocale– Mã nhận dạng ngôn ngữ và quốc gia/khu vực của người dùng. Ví dụ:en-US.commonEventObject.timeZone.offset—Mức chênh lệch múi giờ của người dùng, tính bằng mili giây, so với Mú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 múi giờ của người dùng.
Xem phần Đối tượng sự kiện để biết thêm thông tin chi tiết.
Đối tượng sự kiện được chuyển đến hàm callback hành động khi người dùng tương tác với tiện ích bổ sung của bạn, cũng như đến trang chủ và hàm kích hoạt theo ngữ cảnh. Mỗi lệnh gọi lại hoặc hàm kích hoạt có thể đọc thông tin về ngôn ngữ và múi giờ từ đối tượng sự kiện và sử dụng thông tin đó khi cần. Ví dụ: hàm callback đang di chuyển đến một thẻ mới có thể tham chiếu đến chuỗi ngôn ngữ khi quyết định văn bản cần thêm vào thẻ.