Class User
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Pengguna
Pengguna yang terkait dengan file di Google Drive. Pengguna dapat diakses dari File.getEditors()
, Folder.getViewers()
, dan metode lainnya.
// Log the email address of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
Logger.log(editors[i].getEmail());
}
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
getDomain() | String | Mendapatkan nama domain yang terkait dengan akun pengguna. |
getEmail() | String | Mendapatkan alamat email pengguna. |
getName() | String | Mendapatkan nama pengguna. |
getPhotoUrl() | String | Mendapatkan URL untuk foto pengguna. |
Metode yang tidak digunakan lagi
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
getUserLoginId()
| String | Mendapatkan alamat email pengguna. |
Dokumentasi mendetail
getDomain()
Mendapatkan nama domain yang terkait dengan akun pengguna.
// Log the domain names associated with all users who have edit access to a
// file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
Logger.log(editors[i].getDomain());
}
Pulang pergi
String
— nama domain yang terkait dengan akun pengguna
getEmail()
Mendapatkan alamat email pengguna. Alamat email pengguna hanya tersedia jika pengguna telah
memilih untuk membagikan alamat dari halaman setelan akun Google+, atau jika pengguna berada di
domain yang sama dengan pengguna yang menjalankan skrip dan administrator domain telah mengizinkan semua
pengguna dalam domain untuk melihat alamat email pengguna lain.
// Log the email address of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
Logger.log(editors[i].getEmail());
}
Pulang pergi
String
— alamat email pengguna, atau string kosong jika alamat email tidak tersedia
getName()
Mendapatkan nama pengguna. Metode ini menampilkan null
jika nama pengguna tidak tersedia.
// Log the names of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
Logger.log(editors[i].getName());
}
Pulang pergi
String
— nama pengguna, atau null
jika nama tidak tersedia
getPhotoUrl()
Mendapatkan URL untuk foto pengguna. Metode ini menampilkan null
jika foto pengguna tidak
tersedia.
// Log the URLs for the photos of all users who have edit access to a file.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const editors = file.getEditors();
for (let i = 0; i < editors.length; i++) {
Logger.log(editors[i].getPhotoUrl());
}
Pulang pergi
String
— URL untuk foto pengguna, atau null
jika foto tidak tersedia
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\u003eA User in Google Drive represents an individual associated with a file or folder, accessible through methods like \u003ccode\u003egetEditors()\u003c/code\u003e and \u003ccode\u003egetViewers()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve user information such as their domain, email address, name, and photo URL using dedicated methods of the \u003ccode\u003eUser\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetUserLoginId()\u003c/code\u003e method is deprecated and has been replaced by \u003ccode\u003egetEmail()\u003c/code\u003e for accessing a user's email address.\u003c/p\u003e\n"],["\u003cp\u003eUser email addresses might not be available if privacy settings restrict access or if domain-wide sharing isn't enabled.\u003c/p\u003e\n"],["\u003cp\u003eUser names and photo URLs may return \u003ccode\u003enull\u003c/code\u003e if they are not available or have not been set by the user.\u003c/p\u003e\n"]]],[],null,["# Class User\n\nUser\n\nA user associated with a file in Google Drive. Users can be accessed from [File.getEditors()](/apps-script/reference/drive/file#getEditors()), [Folder.getViewers()](/apps-script/reference/drive/folder#getViewers()), and other methods.\n\n```javascript\n// Log the email address of all users who have edit access to a file.\nconst file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');\nconst editors = file.getEditors();\nfor (let i = 0; i \u003c editors.length; i++) {\n Logger.log(editors[i].getEmail());\n}\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------|-------------|----------------------------------------------------------|\n| [getDomain()](#getDomain()) | `String` | Gets the domain name associated with the user's account. |\n| [getEmail()](#getEmail()) | `String` | Gets the user's email address. |\n| [getName()](#getName()) | `String` | Gets the user's name. |\n| [getPhotoUrl()](#getPhotoUrl()) | `String` | Gets the URL for the user's photo. |\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``Domain()`\n\nGets the domain name associated with the user's account.\n\n```javascript\n// Log the domain names associated with all users who have edit access to a\n// file.\nconst file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');\nconst editors = file.getEditors();\nfor (let i = 0; i \u003c editors.length; i++) {\n Logger.log(editors[i].getDomain());\n}\n```\n\n#### Return\n\n\n`String` --- the domain name associated with the user's account\n\n*** ** * ** ***\n\n### `get``Email()`\n\nGets the user's email address. The user's email address is only available if the user has\nchosen to share the address from the Google+ account settings page, or if the user belongs to\nthe same domain as the user running the script and the domain administrator has allowed all\nusers within the domain to see other users' email addresses.\n\n```javascript\n// Log the email address of all users who have edit access to a file.\nconst file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');\nconst editors = file.getEditors();\nfor (let i = 0; i \u003c editors.length; i++) {\n Logger.log(editors[i].getEmail());\n}\n```\n\n#### Return\n\n\n`String` --- the user's email's address, or a blank string if the email address is not available\n\n*** ** * ** ***\n\n### `get``Name()`\n\nGets the user's name. This method returns `null` if the user's name is not available.\n\n```javascript\n// Log the names of all users who have edit access to a file.\nconst file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');\nconst editors = file.getEditors();\nfor (let i = 0; i \u003c editors.length; i++) {\n Logger.log(editors[i].getName());\n}\n```\n\n#### Return\n\n\n`String` --- the user's name, or `null` if the name is not available\n\n*** ** * ** ***\n\n### `get``Photo``Url()`\n\nGets the URL for the user's photo. This method returns `null` if the user's photo is not\navailable.\n\n```javascript\n// Log the URLs for the photos of all users who have edit access to a file.\nconst file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');\nconst editors = file.getEditors();\nfor (let i = 0; i \u003c editors.length; i++) {\n Logger.log(editors[i].getPhotoUrl());\n}\n```\n\n#### Return\n\n\n`String` --- the URL for the user's photo, or `null` if the photo is not available\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."]]