Class User
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ユーザーユーザーを表すオブジェクト。スクリプト作成に適しています。
メソッド
メソッド | 戻り値の型 | 概要 |
getEmail() | 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
- ユーザーのメールアドレス。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 2025-07-26 UTC。"],[[["\u003cp\u003eRepresents a user for scripting purposes, providing methods to access user information.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetEmail()\u003c/code\u003e retrieves the user's email address if permitted by security policies, returning a blank string otherwise.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetUserLoginId()\u003c/code\u003e is deprecated and replaced by \u003ccode\u003egetEmail()\u003c/code\u003e for retrieving the user's email address.\u003c/p\u003e\n"],["\u003cp\u003eAccess to the user's email address might be restricted in certain contexts due to security considerations, such as unauthorized script execution.\u003c/p\u003e\n"]]],[],null,["# Class User\n\nUser\n\nRepresentation of a user, suitable for scripting. \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------|-------------|----------------------------------------------|\n| [getEmail()](#getEmail()) | `String` | Gets the user's email address, if available. |\n\n### Deprecated methods\n\n| Method | Return type | Brief description |\n|---------------------------------------|-------------|--------------------------------|\n| [getUserLoginId()](#getUserLoginId()) | `String` | Gets the user's email address. |\n\nDetailed documentation\n----------------------\n\n### `get``Email()`\n\nGets the user's email address, if available. If security policies do not allow access to the\nuser's email address, this method returns a blank string. The circumstances in which the email\naddress is available vary: for example, the user's email address is not available in any\ncontext that allows a script to run without that user's authorization, like a simple `on``Open(e)` or `on``Edit(e)` trigger, a custom function in Google Sheets, or a web app\ndeployed to \"execute as me\" (that is, authorized by the developer instead of the user).\nHowever, these restrictions generally do not apply if the developer runs the script themselves\nor belongs to the same Google Workspace domain as the user.\n\n```javascript\n// Log the email address of the person running the script.\nLogger.log(Session.getActiveUser().getEmail());\n```\n\n#### Return\n\n\n`String` --- The user's email's address, or a blank string if security policies do not allow access\nto the user's email address.\n\nDeprecated methods\n------------------\n\n### `get``User``Login``Id()`\n\n\n**Deprecated.** As of June 24, 2013, replaced by [getEmail()](#getEmail()).\n\nGets the user's email address.\n\n```javascript\n// Log the email address of the person running the script.\nLogger.log(Session.getActiveUser().getUserLoginId());\n```\n\n#### Return\n\n\n`String` --- The user's email's address."]]