Class Session

Phiên

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ứ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 một 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 chạy tập lệnh.
getScriptTimeZone()StringLấy múi giờ của tập lệnh.
getTemporaryActiveUserKey()StringLấy 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, thì User.getEmail() sẽ trả về một chuỗi trống. Các trường hợp có thể sử dụng địa chỉ email sẽ khác nhau: ví dụ: địa chỉ email của người dùng không có trong bất kỳ ngữ cảnh nào cho phép tập lệnh chạy mà không cần người dùng đó cho phép, chẳng hạn như trình kích hoạt onOpen(e) hoặc onEdit(e) đơn giản, hàm tuỳ chỉnh trong Google Trang tính hoặc ứng dụng web được triển khai để "thực thi dưới dạng tôi" (tức là được nhà phát triển cho phép thay vì người dùng). Tuy nhiên, các quy định 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 yêu cầu đượ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 đại diện cho 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 chạy tập lệnh. 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ì 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 một trình kích hoạt có thể cài đặt, thì thao tác 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, 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.
const email = Session.getEffectiveUser().getEmail();
Logger.log(email);

Cầu thủ trả bóng

User – người dùng có thẩm 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 yêu cầu đượ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. Các tập lệnh mới 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 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 biệt. 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à nguồn thường xuyên 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()

Lấy 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 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 đang hoạt động tạm thời

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