Lấy thông tin về ngôn ngữ và múi giờ của người dùng
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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.useLocaleFromApp
sang true.
Nếu chưa có, hãy thêm phạm vi rõ ràng sau đây vào
oauthScopes củ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.
Đố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ẻ.