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.
Các 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, đồng thời 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 thông tin về ngôn ngữ và múi giờ của người dùng bằng 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.useLocaleFromApp thành true.
Nếu chưa có, hãy thêm phạm vi rõ ràng sau đây vào danh sách oauthScopes của tệp kê khai: 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, thì người dùng phải uỷ quyền lại cho 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 chứa thông tin về 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 xuất hiện trong cấu trúc phụ commonEventObject của đối tượng sự kiện:
commonEventObject.userLocale – Giá trị 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 – Độ lệch múi giờ của người dùng, tính bằng 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 truyền đến hàm gọi lại thao tác 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à các 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ụ: một hàm gọi lại đang 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ẻ.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2024-12-22 UTC."],[[["Google Workspace add-ons can be configured to access and utilize a user's locale and timezone for customization."],["Add-on developers must set `addOns.common.useLocaleFromApp` to `true` and include the `https://www.googleapis.com/auth/script.locale` scope in the manifest file for locale and timezone access."],["Event objects provide the user's locale and timezone information through fields like `userLocale`, `timeZone.offset`, and `timeZone.id`, which add-ons can utilize in their functions."],["After adding the necessary scope, users need to re-authorize the add-on for the changes to take effect."],["Add-ons should only request necessary scopes and consider removing unused ones, especially those previously used for locale and timezone access through other APIs or services."]]],["Google Workspace add-ons can access user locale and timezone by configuring the add-on manifest. Set `addOns.common.useLocaleFromApp` to `true` and add `https://www.googleapis.com/auth/script.locale` to `oauthScopes`. This requires users to re-authorize the add-on. Event objects contain `userLocale`, `timeZone.offset`, and `timeZone.id`. Callback functions and trigger functions read this information from the event object to customize the add-on's interface and behavior, such as text on cards.\n"]]
