Class User

使用者

使用者表示法，適合用於指令碼。

方法

方法	傳回類型	簡短說明
getEmail()	String	取得使用者的電子郵件地址 (如有)。

已淘汰的方法

方法	傳回類型	簡短說明
getUserLoginId()	String	取得使用者的電子郵件地址。

內容詳盡的說明文件

getEmail()

取得使用者的電子郵件地址 (如有)。如果安全性政策不允許存取使用者的電子郵件地址，這個方法會傳回空白字串。可使用電子郵件地址的情況各有不同：舉例來說，如果使用者在未經使用者授權的情況下，允許指令碼執行，則使用者電子郵件地址就無法使用，例如簡單的 onOpen(e) 或 onEdit(e) 觸發條件、Google 試算表中的自訂函式，或是以「以我身分執行」方式部署的網頁應用程式 (也就是由開發人員而非使用者授權)。不過，如果開發人員自行執行指令碼，或是與使用者屬於相同的 Google Workspace 網域，則這些限制通常不適用。

// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getEmail());

回攻員

String：使用者的電子郵件地址，如果安全性政策不允許存取使用者的電子郵件地址，則為空白字串。

已淘汰的方法

getUserLoginId()

已淘汰。自 2013 年 6 月 24 日起，已由 getEmail() 取代。

取得使用者的電子郵件地址。

// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getUserLoginId());

回攻員

String：使用者的電子郵件地址。