Xem ngôn ngữ và múi giờ của người dùng tiện ích bổ sung của Google Workspace

Hướng dẫn này giải thích cách một tiện ích bổ sung có thể nhận ngôn ngữ và múi giờ của người dùng, sau đó sử dụng thông tin đó để tuỳ chỉnh giao diện và hành vi của tiện ích bổ sung. Để biết hướng dẫn dành riêng cho Google Apps Script, hãy xem phần Nhận ngôn ngữ và múi giờ của người dùng trong tài liệu dành cho nhà phát triển Apps Script.

Định cấu hình tài nguyên triển khai của tiện ích bổ sung

Để cho phép tiện ích bổ sung nhận ngôn ngữ và múi giờ của người dùng, hãy định cấu hình tài nguyên triển khai của tiện ích bổ sung đó:

  1. Trong tài nguyên triển khai của tiện ích bổ sung, hãy đặt trường addOns.common.useLocaleFromApp thành true.
  2. Thêm phạm vi uỷ quyền https://www.googleapis.com/auth/script.locale vào danh sách oauthScopes của tài nguyên triển khai. Phạm vi này cấp cho tiện ích bổ sung quyền xem quốc gia, ngôn ngữ và múi giờ của người dùng.
  3. Lưu tài nguyên triển khai đã cập nhật.

Sau khi thêm phạm vi vào danh sách oauthScopes của tiện ích bổ sung, người dùng phải uỷ quyền lại cho tiện ích bổ sung vào lần tiếp theo họ sử dụng tiện ích bổ sung đó.

Nhận thông tin về ngôn ngữ và múi giờ

Đối tượng sự kiện bao gồm thông tin về ngôn ngữ của người dùng mà bạn có thể lấy từ các thuộc tính commonEventObject sau:

  • commonEventObject.userLocale – Ngôn ngữ và mã nhận dạng quốc gia hoặc khu vực của người dùng. Ví dụ: en-US thể hiện tiếng Anh như được nói ở Hoa Kỳ.
  • 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) từ 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 action, homepageTrigger và contextualTrigger khi người dùng tương tác với tiện ích bổ sung, chẳng hạn như nhấp vào nút. Mỗi lệnh gọi lại hoặc hàm kích hoạt có thể lấy thông tin về ngôn ngữ và múi giờ từ các đối tượng sự kiện và sử dụng thông tin đó khi cần. Ví dụ: một hàm callback điều hướng đế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ẻ.