Class User
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Pengguna
Representasi pengguna, cocok untuk pembuatan skrip.
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
getEmail() | String | Mendapatkan alamat email pengguna, jika tersedia. |
Metode yang tidak digunakan lagi
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
getUserLoginId() | String | Mendapatkan alamat email pengguna. |
Dokumentasi mendetail
getEmail()
Mendapatkan alamat email pengguna, jika tersedia. Jika kebijakan keamanan tidak mengizinkan akses ke alamat email pengguna, metode ini akan menampilkan string kosong. Keadaan saat alamat email tersedia bervariasi: misalnya, alamat email pengguna tidak tersedia dalam konteks apa pun yang memungkinkan skrip berjalan tanpa otorisasi pengguna tersebut, seperti pemicu onOpen(e) atau onEdit(e) sederhana, fungsi kustom di Google Spreadsheet, atau aplikasi web yang di-deploy untuk "dieksekusi sebagai saya" (yaitu, diotorisasi oleh developer, bukan pengguna).
Namun, batasan ini umumnya tidak berlaku jika developer menjalankan skrip sendiri
atau termasuk dalam domain Google Workspace yang sama dengan pengguna.
// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getEmail());
Pulang pergi
String — Alamat email pengguna, atau string kosong jika kebijakan keamanan tidak mengizinkan akses
ke alamat email pengguna.
Metode yang tidak digunakan lagi
getUserLoginId()
Tidak digunakan lagi. Mulai 24 Juni 2013, diganti dengan getEmail().
Mendapatkan alamat email pengguna.
// Log the email address of the person running the script.
Logger.log(Session.getActiveUser().getUserLoginId());
Pulang pergi
String — Alamat email pengguna.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
