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à 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 |
---|---|---|
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 một chuỗi (ví dụ: en cho tiếng Anh). |
getEffectiveUser() | User | Lấy thông tin về người dùng thuộ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 của 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, User.getEmail()
sẽ trả về một chuỗi trống. Các trường hợp có sẵn địa chỉ email sẽ khác nhau: ví dụ: địa chỉ email của người dùng không có sẵn trong bất kỳ ngữ cảnh nào cho phép tập lệnh chạy mà không có 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 một ứng dụng web được triển khai để "thực thi dưới dạng tôi" (nghĩa 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. 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 cần được uỷ 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 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 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 thuộc thẩm quyền mà tập lệnh đang chạy. Nếu tập lệnh là một ứng dụng web được đặt thành "thực thi dưới dạng tôi" (nhà phát triển), thì tác vụ 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 một điều kiện kích hoạt có thể cài đặt, thì tập lệnh 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 trường hợp khác, phương thức 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 cần được uỷ 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 sẽ mặc định theo 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 File > Project Properties (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úi giờ riêng mà bạn có thể thay đổi bằng cách nhấp vào phần Tệp > Cài đặt bảng tính trong Google Trang tính. Múi giờ trong 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ây ra lỗi tập lệnh.
// 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 của người dùng. Khoá tạm thời xoay vòng 30 ngày một lần và là 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 đang hoạt động tạm thời