Lớp Phiên cung cấp quyền truy cập vào thông tin phiên, chẳng hạn như địa chỉ email của người dùng (trong một số trường hợp) và chế độ cài đặt ngôn ngữ.
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
get | User | Lấy thông tin về người dùng hiện tại. |
get | String | Lấy chế độ cài đặt ngôn ngữ của người dùng hiện tại dưới dạng một chuỗi, ví dụ: en cho tiếng Anh. |
get | User | Lấy thông tin về người dùng mà tập lệnh đang chạy dưới quyền của họ. |
get | String | Lấy múi giờ của tập lệnh. |
get | String | Nhận một khoá tạm thời dành riêng cho người dùng đang hoạt động nhưng không tiết lộ danh tính người dùng. |
Tài liệu chi tiết
getActiveUser()
Lấy thông tin về người dùng hiện tại. Nếu chính sách bảo mật không cho phép truy cập vào danh tính của người dùng, thì User.getEmail() sẽ trả về một chuỗi trống. Các trường hợp có sẵn địa chỉ email rất đa dạng: ví dụ: địa chỉ email của người dùng không có sẵn trong bất kỳ bối cảnh nào cho phép tập lệnh chạy mà không cần có sự cho phép của người dùng đó, chẳng hạn như một trình kích hoạt onOpen(e) hoặc onEdit(e) đơn giản, một hàm tuỳ chỉnh trong Google Trang tính hoặc một ứng dụng web được triển khai để "thực thi dưới tư cách là tôi" (tức là được nhà phát triển uỷ quyền thay vì người dùng).
Tuy nhiên, những hạn chế này thường không áp dụng nếu nhà phát triển tự chạy tập lệnh hoặc thuộc cùng một miền Google Workspace với người dùng.
// Log the email address of the person running the script. const email = Session.getActiveUser().getEmail(); Logger.log(email);
Cầu thủ trả bóng
User – người dùng hiện tại
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/userinfo.email
getActiveUserLocale()
Lấy chế độ cài đặt ngôn ngữ của người dùng hiện tại dưới dạng một chuỗi, ví dụ: en cho tiếng Anh.
// Log the language setting of the person running the script. Logger.log(Session.getActiveUserLocale());
Cầu thủ trả bóng
String – một chuỗi biểu thị chế độ cài đặt ngôn ngữ của người dùng
getEffectiveUser()
Lấy thông tin về người dùng mà tập lệnh đang chạy dưới quyền của họ. Nếu tập lệnh là một ứng dụng web được đặt thành "thực thi dưới tư cách của tôi" (nhà phát triển), thì thao tác này sẽ trả về tài khoản người dùng của nhà phát triển. Nếu tập lệnh đang chạy trong trình kích hoạt có thể cài đặt, thì hàm này sẽ trả về tài khoản của người dùng đã tạo trình kích hoạt. Trong hầu hết các trường hợp khác, hàm này sẽ trả về cùng một tài khoản với getActiveUser().
// Log the email address of the user under whose authority the script is // running. const email = Session.getEffectiveUser().getEmail(); Logger.log(email);
Cầu thủ trả bóng
User – người dùng có quyền chạy tập lệnh
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/userinfo.email
getScriptTimeZone()
Lấy múi giờ của tập lệnh. Theo mặc định, tập lệnh mới sẽ sử dụng múi giờ của chủ sở hữu, nhưng bạn có thể thay đổi múi giờ của tập lệnh bằng cách nhấp vào Tệp > Thuộc tính của dự án trong trình chỉnh sửa tập lệnh. Xin lưu ý rằng bảng tính có một múi giờ riêng. Bạn có thể thay đổi múi giờ này bằng cách nhấp vào Tệp > Cài đặt bảng tính trong Google Trang tính. Múi giờ của bảng tính khác với múi giờ của tập lệnh là một nguồn thường gặp gây ra lỗi tập lệnh.
// Log the time zone of the script. const timeZone = Session.getScriptTimeZone(); Logger.log(timeZone);
Cầu thủ trả bóng
String – múi giờ của tập lệnh
getTemporaryActiveUserKey()
Nhận một khoá tạm thời dành riêng cho người dùng đang hoạt động nhưng không tiết lộ danh tính người dùng. Khoá tạm thời sẽ thay đổi sau mỗi 30 ngày và là khoá riêng biệt cho từng tập lệnh.
// Log the temporary key of the person running the script. Logger.log(Session.getTemporaryActiveUserKey());
Cầu thủ trả bóng
String – khoá người dùng đang hoạt động tạm thời