Class Session

Phiên

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ứcLoại dữ liệu trả vềMô tả ngắn
getActiveUser()UserLấy thông tin về người dùng hiện tại.
getActiveUserLocale()StringLấ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()UserLấy thông tin về người dùng có thẩm quyền mà tập lệnh đang chạy.
getScriptTimeZone()StringLấy múi giờ của tập lệnh.
getTemporaryActiveUserKey()StringNhậ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

Các phương thức ngừng hoạt động