Lớp Phiên cung cấp quyền truy cập vào thông tin về 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à cài đặt ngôn ngữ.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
getActiveUser() | User | Lấy thông tin về người dùng hiện tại. |
getActiveUserLocale() | String | Lấy chế độ cài đặt ngôn ngữ của người dùng hiện tại dưới dạng chuỗi (ví dụ: en cho tiếng Anh). |
getEffectiveUser() | User | Lấy thông tin về người dùng có thẩm quyền mà tập lệnh đang chạy. |
getScriptTimeZone() | String | Lấy múi giờ của tập lệnh. |
getTemporaryActiveUserKey() | String | Nhận 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
mã nhận dạng, User.getEmail()
sẽ trả về một chuỗi trống. Các trường hợp trong đó
địa chỉ email có sẵn khác nhau: ví dụ: địa chỉ email của người dùng không có trong bất kỳ
ngữ cảnh cho phép một tập lệnh chạy mà không cần sự cho phép của người dùng đó, chẳng hạn như một điều kiện 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 ứng dụng web
được triển khai để "thực thi như 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 miền Google Workspace với người dùng.
// Log the email address of the person running the script. var 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
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
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 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 thể hiện chế độ cài đặt ngôn ngữ của người dùng
getEffectiveUser()
Lấy thông tin về người dùng có thẩm quyền mà tập lệnh đang chạy. Nếu tập lệnh là
ứng dụng web được đặt thành "thực thi như tôi" (nhà phát triển), thì hệ thống 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 lệnh cài đặt
trình kích hoạt, hàm này sẽ trả về tài khoản của người dùng đã tạo điều kiện kích hoạt. Trong hầu hết các
trong trường hợp này, 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. var email = Session.getEffectiveUser().getEmail(); Logger.log(email);
Cầu thủ trả bóng
User
– người dùng có thẩm quyền mà tập lệnh đang chạy
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/userinfo.email
getScriptTimeZone()
Lấy múi giờ của tập lệnh. Tập lệnh mới được đặt mặc định theo múi giờ của chủ sở hữu, nhưng 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 dự án trong tập lệnh trình chỉnh sửa. Lưu ý rằng các bảng tính có múi giờ riêng, bạn có thể thay đổi múi giờ bằng cách nhấp vào biểu tượng Tệp > Cài đặt bảng tính trong Google Trang tính. Múi giờ bảng tính khác với múi giờ của tập lệnh là nguồn lỗi tập lệnh thường xuyên.
// Log the time zone of the script. var 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 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ẽ xoay vòng mỗi 30 ngày và là khoá duy nhất cho 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 hoạt động tạm thời