REST Resource: users

Resource: Pengguna

Directory API memungkinkan Anda membuat dan mengelola pengguna, alias pengguna, dan foto profil Google pengguna akun. 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 utama 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 {i>password<i} untuk akun pengguna. Nilai sandi pengguna diperlukan saat membuat akun pengguna. Ini bersifat opsional saat memperbarui pengguna dan hanya boleh diberikan jika pengguna memperbarui sandi akun mereka. Nilai sandi tidak pernah ditampilkan dalam isi respons API.

Sandi dapat berisi kombinasi karakter ASCII apa pun, dan harus antara 8-100 karakter.

Sebaiknya kirim parameter password sebagai nilai hash yang dienkode 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 sederhana yang dienkode hex.
  • SHA-1 - Menerima nilai sederhana yang dienkode hex.
  • crypt - Mematuhi library crypt C. Mendukung algoritma hash DES, MD5 (awalan hash $1$), SHA-256 (awalan hash $5$), dan SHA-512 (awalan hash $6$).

Jika ditentukan sebagai bagian dari awalan, putaran harus berjumlah 10.000 atau kurang.
isAdmin

boolean

Hanya output. Menunjukkan pengguna dengan hak istimewa admin super. Properti isAdmin hanya dapat diedit dalam operasi Membuat pengguna menjadi administrator ( metode makeAdmin). Jika diedit di metode insert atau update pengguna, pengeditan akan diabaikan oleh layanan API.
isDelegatedAdmin

boolean

Hanya output. Menunjukkan apakah pengguna adalah administrator yang didelegasikan.
Administrator yang didelegasikan 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 apakah pengguna dipaksa untuk mengubah sandinya saat login berikutnya. Setelan ini tidak berlaku jika pengguna login melalui penyedia identitas pihak ketiga.
ipWhitelisted

boolean

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

object (UserName)

Menyimpan nama pengguna yang diberikan dan nama keluarga, serta nilai fullName hanya baca. Jumlah karakter maksimum dalam nilai givenName dan 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 utama 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 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 mengetahui 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 yang dijual kembali. Untuk mendapatkan customerId, gunakan domain utama akun di 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 yang 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 atau kota alamat.

addresses[].poBox

string

Kotak pos, jika ada.

addresses[].postalCode

string

Kode pos, jika berlaku.

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 telah diformat. Alamat berformat saat ini tidak didukung.

addresses[].streetAddress

string

Alamat, seperti 1600 Amphitheatre Parkway. Spasi kosong dalam string akan diabaikan; namun, 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 jenisnya adalah kustom, properti ini akan 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 boleh 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. Nilainya dalam format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam bentuk 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_fax, work_mobile, work_pager.

phones[].value

string

Nomor telepon yang dapat dibaca manusia. Nomor telepon dapat dalam format apa pun.
suspensionReason

string

Hanya output. Memiliki alasan akun pengguna ditangguhkan 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 tersebut 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 lain. Pengguna dapat memberikan nama bahasanya sendiri jika tidak ada kode bahasa ISO 639 yang sesuai. Jika ditetapkan, languageCode tidak dapat ditetapkan.

languages[].languageCode

string

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

languages[].preference

string

Opsional. Jika ada, mengontrol apakah languageCode yang ditentukan adalah bahasa pilihan pengguna. Jika customLanguage ditetapkan, nilai ini tidak dapat ditetapkan. 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 beranda 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 untuk akun yang Nama Pengguna atau UID-nya berlaku.

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 ini dalam format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam bentuk 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. Domain ini biasanya berada di luar domain primer atau sub-domain 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 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 maupun HTML. Defaultnya adalah teks biasa.

Nilai yang dapat diterima: text_plain, text_html.

notes.value

string

Konten catatan.
websites

value (Value format)

Daftar situs pengguna.

Kolom

websites[].customType

string

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

websites[].primary

boolean

Jika true, situs 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 disetel ke custom, customType juga harus disetel.

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 singkat. 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 dari setiap lokasi meja.

locations[].floorName

string

Nama/nomor lantai.

locations[].floorSection

string

Bagian lantai. Lokasi yang lebih spesifik dalam lantai. Misalnya, jika lantai dibagi menjadi bagian A, B, dan C, kolom ini akan mengidentifikasi salah satu 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 di daftar alamat global Google Workspace saat fitur berbagi kontak diaktifkan untuk domain. Untuk informasi selengkapnya tentang cara 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 berupa jenis occupation atau outlook. Selain jenis standar, entri dapat memiliki jenis custom dan dapat diberi 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. Nilainya dalam format tanggal dan waktu ISO 8601. Waktu adalah tanggal lengkap plus jam, menit, dan detik dalam bentuk 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 yang berisi cara yang tepat untuk merujuk ke pemilik profil oleh manusia, misalnya "dia" atau "mereka".

gender.customGender

string

Nama gender kustom.

gender.type

string

 Jenis gender.

Nilai yang dapat 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 salah satu dari properti ims ini yang dapat menjadi kontak IM utama.

Kolom

ims[].customProtocol

string

Jika nilai protokol adalah custom_protocol, properti ini 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 dapat memiliki nilai benar.

ims[].protocol

string

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

Nilai yang dapat 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 Net Meeting
  • 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 di 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 tersebut akan direpresentasikan sebagai garis miring (/).
recoveryEmail

string

Email pemulihan pengguna.
recoveryPhone

string

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 dibentuk dengan menggabungkan nilai nama depan dan nama belakang.
familyName

string

Nama belakang pengguna. Diperlukan saat membuat akun pengguna.
givenName

string

Nama depan pengguna. Wajib 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 yang di-paging dari pengguna yang dihapus atau semua pengguna di domain.

makeAdmin

 Mengubah pengguna menjadi administrator super.

patch

 Memperbarui pengguna menggunakan semantik patch.

signOut

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

undelete

 Menghapus penghapusan pengguna.

update

 Memperbarui pengguna.

watch

 Mengamati perubahan dalam daftar pengguna.