REST Resource: users

Referensi: Pengguna

Directory API memungkinkan Anda membuat dan mengelola pengguna, alias pengguna, dan foto profil Google milik akun Anda. Untuk informasi selengkapnya tentang tugas umum, lihat Panduan Developer Akun Pengguna dan Panduan Developer Alias Pengguna.

Representasi JSON
{
  "id": string,
  "primaryEmail": string,
  "password": value,
  "hashFunction": string,
  "isAdmin": boolean,
  "isDelegatedAdmin": boolean,
  "agreedToTerms": boolean,
  "suspended": boolean,
  "changePasswordAtNextLogin": boolean,
  "ipWhitelisted": boolean,
  "name": {
    object (UserName)
  },
  "kind": string,
  "etag": string,
  "emails": value,
  "externalIds": value,
  "relations": value,
  "aliases": [
    string
  ],
  "isMailboxSetup": boolean,
  "customerId": string,
  "addresses": value,
  "organizations": value,
  "lastLoginTime": string,
  "phones": value,
  "suspensionReason": string,
  "thumbnailPhotoUrl": string,
  "languages": value,
  "posixAccounts": value,
  "creationTime": string,
  "nonEditableAliases": [
    string
  ],
  "sshPublicKeys": value,
  "notes": value,
  "websites": value,
  "locations": value,
  "includeInGlobalAddressList": boolean,
  "keywords": value,
  "deletionTime": string,
  "gender": value,
  "thumbnailPhotoEtag": string,
  "ims": value,
  "customSchemas": value,
  "isEnrolledIn2Sv": boolean,
  "isEnforcedIn2Sv": boolean,
  "archived": boolean,
  "orgUnitPath": string,
  "recoveryEmail": string,
  "recoveryPhone": string
}
Kolom
id

string

ID unik untuk pengguna. id pengguna dapat digunakan sebagai userKey URI permintaan pengguna.

primaryEmail

string

Alamat email primer pengguna. Properti ini diperlukan dalam permintaan untuk membuat akun pengguna. primaryEmail harus unik dan tidak boleh berupa alias pengguna lain.

password

value (Value format)

Menyimpan sandi untuk akun pengguna. Nilai sandi pengguna wajib diisi saat membuat akun pengguna. Atribut ini bersifat opsional saat memperbarui pengguna dan hanya diberikan jika pengguna memperbarui sandi akunnya. Nilai sandi tidak pernah ditampilkan dalam isi respons API.

Sandi dapat berisi kombinasi karakter ASCII, dan harus terdiri dari 8-100 karakter.

Sebaiknya kirim parameter password sebagai nilai hash yang dienkode dengan heksadesimal dan tetapkan hashFunction sebagaimana mestinya. Jika hashFunction ditentukan, sandi harus berupa kunci hash yang valid.

hashFunction

string

Menyimpan format hash properti password. Nilai hashFunction berikut diizinkan:

  • MD5 - Menerima nilai berenkode heksadesimal sederhana.
  • SHA-1 - Menerima nilai berenkode heksadesimal sederhana.
  • crypt - Mematuhi library C crypt. Mendukung algoritma hash DES, MD5 (awalan hash $1$), SHA-256 (awalan hash $5$), dan SHA-512 (awalan hash $6$).

Jika bilangan bulat ditentukan sebagai bagian dari awalan, bilangan bulat tersebut harus berjumlah 10.000 atau kurang.

isAdmin

boolean

Hanya output. Menunjukkan pengguna dengan hak istimewa administrator super. Properti isAdmin hanya dapat diedit dalam operasi Menjadikan pengguna sebagai administrator ( metode makeAdmin). Jika diedit pada metode insert atau update pengguna, hasil edit akan diabaikan oleh layanan API.

isDelegatedAdmin

boolean

Hanya output. Menunjukkan apakah pengguna adalah administrator yang didelegasikan.
Administrator delegasi didukung oleh API, tetapi tidak dapat membuat atau membatalkan penghapusan pengguna, atau menjadikan pengguna sebagai administrator. Permintaan ini diabaikan oleh layanan API.
Peran dan hak istimewa untuk administrator ditetapkan menggunakan konsol Admin.

agreedToTerms

boolean

Hanya output. Properti ini adalah true jika pengguna telah menyelesaikan login awal dan menyetujui perjanjian Persyaratan Layanan.

suspended

boolean

Menunjukkan apakah pengguna ditangguhkan.

changePasswordAtNextLogin

boolean

Menunjukkan jika pengguna dipaksa untuk mengubah sandi pada login berikutnya. Setelan ini tidak berlaku jika pengguna login melalui penyedia identitas pihak ketiga.

ipWhitelisted

boolean

Jika true, alamat IP pengguna tunduk pada konfigurasi alamat IP allowlist yang tidak digunakan lagi.

name

object (UserName)

Menyimpan nama depan dan nama keluarga pengguna, serta nilai fullName hanya baca. Jumlah karakter maksimum dalam givenName dan nilai familyName adalah 60. Selain itu, nilai nama mendukung karakter unicode/UTF-8, dan dapat berisi spasi, huruf (a-z), angka (0-9), tanda hubung (-), garis miring (/), dan titik (.). Untuk informasi selengkapnya tentang aturan penggunaan karakter, lihat pusat bantuan administrasi. Ukuran data maksimum yang diizinkan untuk kolom ini adalah 1 KB.

kind

string

Hanya output. Jenis resource API. Untuk resource Pengguna, nilainya adalah admin#directory#user.

etag

string

Hanya output. ETag resource.

emails

value (Value format)

Daftar alamat email pengguna. Ukuran data maksimum yang diizinkan adalah 10 KB.

Kolom

emails[].address

string

Alamat email pengguna. Juga berfungsi sebagai ID email. Nilai ini dapat berupa alamat email primer atau alias pengguna.

emails[].customType

string

Jika alamat email type adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

emails[].primary

boolean

Menunjukkan apakah ini adalah email utama pengguna. Hanya satu entri yang dapat ditandai sebagai entri utama.

emails[].type

string

Jenis akun email. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima: custom, home, other, work.

externalIds

value (Value format)

Daftar ID eksternal untuk pengguna, seperti ID karyawan atau jaringan. Ukuran data maksimum yang diizinkan adalah 2 KB.

Kolom

externalIds[].customType

string

Jika ID eksternal type adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

externalIds[].type

string

Jenis ID eksternal. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima: account, custom, customer, login_id, network, organization.

externalIds[].value

string

Nilai ID eksternal.

relations

value (Value format)

Daftar hubungan pengguna dengan pengguna lain. Ukuran data maksimum yang diizinkan untuk kolom ini adalah 2 KB. Untuk informasi selengkapnya, lihat Mengelola akun pengguna.

Kolom

relations[].customType

string

Jika hubungan type adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

relations[].type

string

Jenis hubungan. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima:
  • admin_assistant
  • assistant
  • brother
  • child
  • custom
  • domestic_partner
  • dotted_line_manager
  • exec_assistant
  • father
  • friend
  • manager
  • mother
  • parent
  • partner
  • referred_by
  • relative
  • sister
  • spouse

relations[].value

string

Alamat email orang yang terkait dengan pengguna.

aliases[]

string

Hanya output. Daftar alamat email alias pengguna.

isMailboxSetup

boolean

Hanya output. Menunjukkan apakah kotak surat Google pengguna dibuat. Properti ini hanya berlaku jika pengguna telah diberi lisensi Gmail.

customerId

string

Hanya output. ID pelanggan untuk mengambil semua pengguna akun.
Anda dapat menggunakan alias my_customer untuk mewakili customerId akun Anda.
Sebagai administrator reseller, Anda dapat menggunakan customerId akun pelanggan reseller. Untuk mendapatkan customerId, gunakan domain primer akun dalam parameter domain dari permintaan users.list.

addresses

value (Value format)

Daftar alamat pengguna. Ukuran data maksimum yang diizinkan adalah 10 KB.

Kolom

addresses[].country

string

Negara.

addresses[].countryCode

string

Kode negara. Menggunakan standar ISO 3166-1.

addresses[].customType

string

Jika alamat type adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

addresses[].extendedAddress

string

Untuk alamat yang diperluas, seperti alamat yang menyertakan sub-wilayah.

addresses[].formatted

string

Alamat pos lengkap dan tidak terstruktur. Ini tidak disinkronkan dengan kolom alamat terstruktur. Mencakup atribut berikut: alamat, P.O. box, kota, negara bagian/provinsi, kode pos, negara/wilayah.

addresses[].locality

string

Kota alamat.

addresses[].poBox

string

Kotak pos, jika ada.

addresses[].postalCode

string

Kode pos, jika ada.

addresses[].primary

boolean

Jika ini adalah alamat utama pengguna. Daftar alamat hanya boleh berisi satu alamat utama.

addresses[].region

string

Provinsi atau negara bagian yang disingkat.

addresses[].sourceIsStructured

boolean

Menunjukkan apakah alamat yang diberikan pengguna diformat. Alamat yang diformat saat ini tidak didukung.

addresses[].streetAddress

string

Alamat, seperti 1600 Amphitheatre Parkway. Spasi kosong dalam string akan diabaikan; tetapi, baris baru bersifat signifikan.

addresses[].type

string

Jenis alamat. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima: custom, home, other, work.

organizations

value (Value format)

Daftar organisasi tempat pengguna berada. Ukuran data maksimum yang diizinkan adalah 10 KB.

Kolom

organizations[].costCenter

string

Pusat biaya organisasi pengguna.

organizations[].customType

string

Jika nilai jenis adalah kustom, properti ini berisi jenis kustom.

organizations[].department

string

Menentukan departemen dalam organisasi, seperti sales atau engineering.

organizations[].description

string

Deskripsi organisasi.

organizations[].domain

string

Domain tempat organisasi berada.

organizations[].fullTimeEquivalent

integer

Milipersen setara purnawaktu dalam organisasi (100000 = 100%).

organizations[].location

string

Lokasi fisik organisasi. Alamat ini tidak harus berupa alamat yang sepenuhnya memenuhi syarat.

organizations[].name

string

Nama organisasi.

organizations[].primary

boolean

Menunjukkan apakah ini adalah organisasi utama pengguna. Pengguna hanya dapat memiliki satu organisasi utama.

organizations[].symbol

string

Simbol string teks organisasi. Misalnya, simbol teks untuk Google adalah GOOG.

organizations[].title

string

Jabatan pengguna dalam organisasi. Misalnya member atau engineer.

organizations[].type

string

Jenis organisasi.

Nilai yang dapat diterima: domain_only, school, unknown, work.

lastLoginTime

string

Hanya output. Terakhir kali pengguna login ke akun pengguna. Nilai menggunakan format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam format YYYY-MM-DDThh:mm:ssTZD. Misalnya, 2010-04-05T17:30:04+01:00.

phones

value (Value format)

Daftar nomor telepon pengguna. Ukuran data maksimum yang diizinkan adalah 1 KB.

Kolom

phones[].customType

string

Jika nomor telepon type adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

phones[].primary

boolean

Jika true, ini adalah nomor telepon utama pengguna. Pengguna hanya boleh memiliki satu nomor telepon utama.

phones[].type

string

Jenis nomor telepon. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima: assistant, callback, car, company_main, custom, grand_central, home, home_fax, isdn, main, mobile, other, other_fax, pager, radio, telex, tty_tdd, work,
,
.work_faxwork_mobilework_pager

phones[].value

string

Nomor telepon yang dapat dibaca manusia. Nomor telepon dapat berupa format apa pun.

suspensionReason

string

Hanya output. Memiliki alasan akun pengguna ditangguhkan, baik oleh administrator atau oleh Google pada saat penangguhan. Properti hanya ditampilkan jika properti suspended adalah true.

thumbnailPhotoUrl

string

Hanya output. URL foto profil pengguna. URL mungkin bersifat sementara atau pribadi.

languages

value (Value format)

Daftar bahasa pengguna. Ukuran data maksimum yang diizinkan adalah 1 KB.

Kolom

languages[].customLanguage

string

Bahasa lainnya. Pengguna dapat memberikan nama bahasanya sendiri jika tidak ada kode bahasa ISO 639 yang sesuai. Jika disetel, languageCode tidak dapat disetel.

languages[].languageCode

string

Representasi string ISO 639 dari suatu bahasa. Lihat Kode Bahasa untuk daftar kode yang didukung. Kode bahasa yang valid di luar kumpulan yang didukung akan diterima oleh API, tetapi dapat menyebabkan perilaku yang tidak diharapkan. Nilai ilegal menyebabkan SchemaException. Jika disetel, customLanguage tidak dapat disetel.

languages[].preference

string

Opsional. Jika ada, mengontrol apakah languageCode yang ditentukan adalah bahasa pilihan pengguna. Jika customLanguage disetel, atribut ini tidak dapat disetel. Nilai yang diizinkan adalah preferred dan not_preferred.

posixAccounts

value (Value format)

Daftar informasi akun POSIX untuk pengguna.

Kolom

posixAccounts[].accountId

string

ID kolom akun POSIX.

posixAccounts[].gecos

string

GECOS (informasi pengguna) untuk akun ini.

posixAccounts[].gid

unsigned long

ID grup default.

posixAccounts[].homeDirectory

string

Jalur ke direktori utama untuk akun ini.

posixAccounts[].operatingSystemType

string

Jenis sistem operasi untuk akun ini.

Nilai yang dapat diterima: linux, unspecified, windows.

posixAccounts[].primary

boolean

Jika ini adalah akun utama pengguna dalam SystemId.

posixAccounts[].shell

string

Jalur ke shell login untuk akun ini.

posixAccounts[].systemId

string

ID sistem tempat Username atau Uid akun diterapkan.

posixAccounts[].uid

unsigned long

ID pengguna yang sesuai dengan POSIX.

posixAccounts[].username

string

Nama pengguna akun.

creationTime

string

Hanya output. Waktu pembuatan akun pengguna. Nilai menggunakan format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam format YYYY-MM-DDThh:mm:ssTZD. Misalnya, 2010-04-05T17:30:04+01:00.

nonEditableAliases[]

string

Hanya output. Daftar alamat email alias pengguna yang tidak dapat diedit. URL ini biasanya berada di luar domain primer atau subdomain akun.

sshPublicKeys

value (Value format)

Daftar kunci publik SSH.

Kolom

sshPublicKeys[].expirationTimeUsec

long

Waktu habis masa berlaku dalam mikrodetik sejak epoch.

sshPublicKeys[].fingerprint

string

Sidik jari SHA-256 dari kunci publik SSH. (Hanya baca)

sshPublicKeys[].key

string

Kunci publik SSH.

notes

value (Value format)

Catatan untuk pengguna sebagai objek bertingkat.

Kolom

notes.contentType

string

Jenis konten catatan, baik teks biasa atau HTML. Defaultnya adalah teks biasa.

Nilai yang diterima: text_plain, text_html.

notes.value

string

Isi catatan.

websites

value (Value format)

Daftar situs pengguna.

Kolom

websites[].customType

string

Jika situs type adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

websites[].primary

boolean

Jika true, ini adalah situs utama pengguna.

websites[].type

string

Jenis atau tujuan situs. Misalnya, situs dapat diberi label sebagai home atau blog. Atau, entri dapat memiliki jenis custom. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima: app_install_page, blog, custom, ftp, home, home_page, other, profile, reservations, resume, work.

websites[].value

string

URL situs.

locations

value (Value format)

Daftar lokasi pengguna. Ukuran data maksimum yang diizinkan adalah 10 KB.

Kolom

locations[].area

string

Lokasi tekstual. Hal ini paling berguna untuk tujuan tampilan guna menggambarkan lokasi secara ringkas. Misalnya Mountain View, CA atau Near Seattle.

locations[].buildingId

string

ID gedung.

locations[].customType

string

Jika lokasi type adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

locations[].deskCode

string

Kode tekstual paling spesifik untuk setiap lokasi meja.

locations[].floorName

string

Nama/nomor lantai.

locations[].floorSection

string

Bagian lantai. Lokasi yang lebih spesifik di dalam lantai. Misalnya, jika lantai dibagi menjadi beberapa bagian A, B, dan C, kolom ini akan mengidentifikasi salah satu dari nilai tersebut.

locations[].type

string

Jenis lokasi. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima: custom, default, desk.

includeInGlobalAddressList

boolean

Menunjukkan apakah profil pengguna terlihat dalam daftar alamat global Google Workspace saat fitur berbagi kontak diaktifkan untuk domain. Untuk informasi selengkapnya tentang mengecualikan profil pengguna, lihat pusat bantuan administrasi.

keywords

value (Value format)

Daftar kata kunci pengguna. Ukuran data maksimum yang diizinkan adalah 1 KB.

Kolom

keywords[].customType

string

Jika kata kunci type adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

keywords[].type

string

Setiap entri dapat memiliki jenis yang menunjukkan jenis standar entri tersebut.

Misalnya, kata kunci dapat berjenis occupation atau outlook. Selain jenis standar, entri dapat memiliki jenis custom dan dapat memberinya nama apa pun. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima: custom, mission, occupation, outlook.

keywords[].value

string

Kata kunci.

deletionTime

string

Hanya output. Waktu akun pengguna dihapus. Nilai menggunakan format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam format YYYY-MM-DDThh:mm:ssTZD. Contohnya, 2010-04-05T17:30:04+01:00.

gender

value (Value format)

Objek bertingkat yang berisi gender pengguna. Ukuran data maksimum yang diizinkan untuk kolom ini adalah 1 KB.

Kolom

gender.addressMeAs

string

String yang dapat dibaca manusia dan berisi cara yang tepat untuk merujuk pemilik profil oleh manusia, misalnya "dia/laki-laki/miliknya" atau "mereka/mereka".

gender.customGender

string

Nama gender khusus.

gender.type

string

Jenis gender.

Nilai yang diterima:
  • female
  • male
  • other
  • unknown

thumbnailPhotoEtag

string

Hanya output. ETag foto pengguna (Hanya baca)

ims

value (Value format)

Akun Instant Messenger (IM) pengguna. Akun pengguna dapat memiliki beberapa properti ims, tetapi hanya satu dari ims properti ini yang dapat menjadi kontak IM utama.

Kolom

ims[].customProtocol

string

Jika nilai protokol adalah custom_protocol, properti ini akan menyimpan string protokol kustom.

ims[].customType

string

Jika type IM adalah custom, properti ini berisi nilai kustom dan harus ditetapkan.

ims[].im

string

ID jaringan IM pengguna.

ims[].primary

boolean

Jika ini adalah IM utama pengguna. Hanya satu entri dalam daftar IM yang boleh memiliki nilai true.

ims[].protocol

string

Protokol IM mengidentifikasi jaringan IM. Nilainya dapat berupa jaringan kustom atau jaringan standar.

Nilai yang diterima:
  • aim: Protokol AOL Instant Messenger
  • custom_protocol: Protokol jaringan IM kustom
  • gtalk: Protokol Google Talk
  • icq: Protokol ICQ
  • jabber: Protokol Jabber
  • msn: Protokol MSN Messenger
  • net_meeting: Protokol Rapat Net
  • qq: Protokol QQ
  • skype: Protokol Skype
  • yahoo: Protokol Yahoo Messenger

ims[].type

string

Jenis akun IM. Jika ditetapkan ke custom, customType juga harus ditetapkan.

Nilai yang dapat diterima: custom, home, other, work.

customSchemas

value (Value format)

Kolom kustom pengguna. Kuncinya adalah schemaName dan nilainya adalah 'fieldName': 'field_value'.

  • customSchemas.(key) adalah objek bertingkat.
  • customSchemas.(key).(key) dapat berupa nilai apa pun.
isEnrolledIn2Sv

boolean

Hanya output. Terdaftar dalam verifikasi 2 langkah (Hanya baca)

isEnforcedIn2Sv

boolean

Hanya output. Apakah verifikasi 2 langkah diterapkan (Hanya baca)

archived

boolean

Menunjukkan apakah pengguna diarsipkan.

orgUnitPath

string

Jalur lengkap organisasi induk yang terkait dengan pengguna. Jika organisasi induk adalah tingkat teratas, organisasi ini dilambangkan dengan garis miring (/).

recoveryEmail

string

Email pemulihan pengguna.

recoveryPhone

string

Nomor telepon pemulihan pengguna. Nomor telepon harus dalam format E.164, dimulai dengan tanda plus (+). Contoh: +16506661212.

UserName

Representasi JSON
{
  "fullName": string,
  "familyName": string,
  "givenName": string,
  "displayName": string
}
Kolom
fullName

string

Nama lengkap pengguna yang dibuat dengan menggabungkan nilai nama depan dan belakang.

familyName

string

Nama belakang pengguna. Diperlukan saat membuat akun pengguna.

givenName

string

Nama depan pengguna. Diperlukan saat membuat akun pengguna.

displayName

string

Nama tampilan pengguna. Batas: 256 karakter.

Metode

delete

Menghapus pengguna.

get

Mengambil pengguna.

insert

Membuat pengguna.

list

Mengambil daftar pengguna yang telah dihapus atau semua pengguna di domain yang telah diberi nomor halaman.

makeAdmin

Membuat pengguna menjadi administrator super.

patch

Mengupdate pengguna menggunakan semantik patch.

signOut

Membuat pengguna logout dari semua sesi web dan perangkat serta mereset cookie login mereka.

undelete

Membatalkan penghapusan pengguna yang dihapus.

update

Memperbarui pengguna.

watch

Mengamati perubahan dalam daftar pengguna.