| id |  string  شناسه منحصر به فرد برای کاربر. idکاربر میتواند بهعنوان درخواست کاربر URI'suserKeyاستفاده شود. | 
| primaryEmail |  string  آدرس ایمیل اصلی کاربر. این ویژگی در درخواست ایجاد یک حساب کاربری مورد نیاز است. Email primaryEmailباید منحصر به فرد باشد و نمی تواند نام مستعار کاربر دیگری باشد. | 
| password |  value ( Valueformat)  رمز عبور حساب کاربری را ذخیره می کند. هنگام ایجاد یک حساب کاربری، مقدار رمز عبور کاربر مورد نیاز است. هنگام بهروزرسانی کاربر اختیاری است و تنها در صورتی باید ارائه شود که کاربر رمز عبور حساب خود را بهروزرسانی کند. مقدار رمز عبور هرگز در بدنه پاسخ API بازگردانده نمی شود.
 رمز عبور می تواند حاوی هر ترکیبی از کاراکترهای ASCII باشد و باید بین 8 تا 100 کاراکتر باشد.
 
 توصیه میکنیم پارامتر
 passwordرا بهعنوان یک مقدار هش کدگذاری شده با هگزادسیمال ارسال کنید و بر این اساس،hashFunctionتنظیم کنید. اگرhashFunctionمشخص شده باشد، رمز عبور باید یک کلید هش معتبر باشد. | 
| hashFunction |  string  فرمت هش ویژگی passwordرا ذخیره می کند. مقادیرhashFunctionزیر مجاز است:  MD5- مقادیر ساده کدگذاری شده هگزا را می پذیرد. SHA-1- مقادیر ساده کدگذاری شده هگزا را می پذیرد. crypt- مطابق با کتابخانه C crypt . از الگوریتم های هش DES، MD5 (پیشوند هش$1$)، SHA-256 (پیشوند هش$5$) و SHA-512 (پیشوند هش$6$) پشتیبانی می کند.
  اگر دور به عنوان بخشی از پیشوند مشخص شده باشد، باید 10000 یا کمتر باشد. | 
| isAdmin |  boolean  فقط خروجی یک کاربر با امتیازات فوق العاده سرپرست را نشان می دهد. ویژگی isAdminفقط می توان در عملیات Make a user an administrator (روش makeAdmin ) ویرایش کرد. اگر در روشهای درج یا بهروزرسانی کاربر ویرایش شود، این ویرایش توسط سرویس API نادیده گرفته میشود. | 
| isDelegatedAdmin |  boolean  فقط خروجی نشان می دهد که آیا کاربر یک سرپرست است.مدیران تفویض شده توسط API پشتیبانی میشوند اما نمیتوانند کاربران را ایجاد یا حذف کنند یا کاربران را سرپرست کنند. این درخواست ها توسط سرویس API نادیده گرفته می شوند.
 نقش ها و امتیازات برای مدیران با استفاده از کنسول Admin اختصاص داده می شود.
 | 
| agreedToTerms |  boolean  فقط خروجی این ویژگی در صورتی trueاست که کاربر یک ورود اولیه را تکمیل کرده باشد و شرایط خدمات را پذیرفته باشد. | 
| suspended |  boolean  نشان می دهد که آیا کاربر به حالت تعلیق درآمده است. | 
| changePasswordAtNextLogin |  boolean  نشان می دهد که آیا کاربر مجبور به تغییر رمز عبور خود در ورود بعدی است یا خیر. وقتی کاربر از طریق ارائهدهنده هویت شخص ثالث وارد سیستم میشود، این تنظیم اعمال نمیشود. | 
| ipWhitelisted |  boolean  اگر true، آدرس IP کاربر مشمول پیکربندیallowlistآدرس IP منسوخ شده است. | 
| name |  object ( UserName)  نام داده شده و نام خانوادگی کاربر و مقدار fullNameفقط خواندنی را در خود دارد. حداکثر تعداد کاراکترها در مقادیرgivenNameو در مقادیرfamilyName60 است. علاوه بر این، مقادیر نام از نویسههای یونیکد/UTF-8 پشتیبانی میکنند و میتوانند شامل فاصله، حروف (az)، اعداد (0-9)، خط تیره (-)، اسلشهای جلو (/)، و نقطه (.) باشند. برای اطلاعات بیشتر در مورد قوانین استفاده از کاراکتر، به مرکز راهنمایی مدیریت مراجعه کنید. حداکثر اندازه مجاز داده برای این فیلد 1 کیلوبایت است. | 
| kind |  string  فقط خروجی نوع منبع API. برای منابع کاربران، مقدار admin#directory#userاست. | 
| etag |  string  فقط خروجی ETag منبع | 
| emails |  value ( Valueformat)  لیست آدرس های ایمیل کاربر. حداکثر اندازه مجاز داده 10 کیلوبایت است. | فیلدها |  |  emails[].address |  string | آدرس ایمیل کاربر. همچنین به عنوان شناسه ایمیل عمل می کند. این مقدار می تواند آدرس ایمیل اصلی کاربر یا نام مستعار باشد. |  |  emails[].customType |  string | اگر typeآدرس ایمیلcustomاست، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  emails[].primary |  boolean | نشان می دهد که آیا این ایمیل اصلی کاربر است یا خیر. فقط یک ورودی را می توان به عنوان اصلی علامت گذاری کرد. |  |  emails[].type |  string | نوع اکانت ایمیل اگر روی customتنظیم شود،customTypeنیز باید تنظیم شود.
 ارزش های قابل قبول:
 custom،home،other،work. | 
 | 
| externalIds |  value ( Valueformat)  لیست شناسه های خارجی برای کاربر، مانند شناسه کارمند یا شبکه. حداکثر اندازه مجاز داده 2 کیلوبایت است. | فیلدها |  |  externalIds[].customType |  string | اگر typeشناسه خارجیcustomباشد، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  externalIds[].type |  string | نوع شناسه خارجی اگر روی customتنظیم شود،customTypeنیز باید تنظیم شود.
 مقادیر قابل قبول:
 account،custom،customer،login_id،network،organization. |  |  externalIds[].value |  string | مقدار شناسه خارجی | 
 | 
| relations |  value ( Valueformat)  لیستی از روابط کاربر با سایر کاربران. حداکثر اندازه مجاز داده برای این فیلد 2 کیلوبایت است. برای اطلاعات بیشتر، به مدیریت حسابهای کاربری مراجعه کنید. | فیلدها |  |  relations[].customType |  string | اگر typeرابطهcustomاست، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  relations[].type |  string | نوع رابطه. اگر روی customتنظیم شود،customTypeنیز باید تنظیم شود.
 ارزش های قابل قبول:
  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 | آدرس ایمیل شخصی که کاربر با او مرتبط است. | 
 | 
| aliases[] |  string  فقط خروجی فهرست آدرسهای ایمیل نام مستعار کاربر. | 
| isMailboxSetup |  boolean  فقط خروجی نشان می دهد که آیا صندوق پست گوگل کاربر ایجاد شده است یا خیر. این ویژگی فقط در صورتی قابل اعمال است که به کاربر مجوز Gmail اختصاص داده شده باشد. | 
| customerId |  string  فقط خروجی شناسه مشتری برای بازیابی همه کاربران حساب .می توانید از نام مستعار
 my_customerبرای نشان دادنcustomerIdحساب خود استفاده کنید.بهعنوان مدیر فروشنده، میتوانید از
 customerIdحساب مشتری فروختهشده استفاده کنید. برای دریافت یکcustomerId، از دامنه اصلی حساب در پارامترdomainدرخواست users.list استفاده کنید. | 
| addresses |  value ( Valueformat)  لیست آدرس های کاربر حداکثر اندازه مجاز داده 10 کیلوبایت است. | فیلدها |  |  addresses[].country |  string | کشور. |  |  addresses[].countryCode |  string | کد کشور از استاندارد ISO 3166-1 استفاده می کند. |  |  addresses[].customType |  string | اگر typeآدرسcustomاست، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  addresses[].extendedAddress |  string | برای آدرس های توسعه یافته، مانند آدرسی که شامل یک منطقه فرعی است. |  |  addresses[].formatted |  string | یک آدرس پستی کامل و بدون ساختار. این با فیلدهای آدرس ساخت یافته همگام سازی نشده است. شامل ویژگی های زیر است: آدرس خیابان، صندوق پستی، شهر، ایالت/استان، کد پستی/پستی، کشور/منطقه. |  |  addresses[].locality |  string | شهر یا شهر آدرس. |  |  addresses[].poBox |  string | صندوق پست در صورت وجود |  |  addresses[].postalCode |  string | کد پستی یا کد پستی، در صورت وجود. |  |  addresses[].primary |  boolean | اگر این آدرس اصلی کاربر است. لیست آدرس ها ممکن است فقط یک آدرس اصلی داشته باشد. |  |  addresses[].region |  string | استان یا ایالت به اختصار. |  |  addresses[].sourceIsStructured |  boolean | نشان می دهد که آیا آدرس ارائه شده توسط کاربر قالب بندی شده است یا خیر. آدرس های قالب بندی شده در حال حاضر پشتیبانی نمی شوند. |  |  addresses[].streetAddress |  string | آدرس خیابان، مانند 1600 Amphitheatre Parkway. فضای خالی درون رشته نادیده گرفته می شود. با این حال، خطوط جدید قابل توجه است. |  |  addresses[].type |  string | نوع آدرس اگر روی customتنظیم شود،customTypeنیز باید تنظیم شود.
 ارزش های قابل قبول:
 custom،home،other،work. | 
 | 
| organizations |  value ( Valueformat)  لیست سازمان هایی که کاربر به آنها تعلق دارد. حداکثر اندازه مجاز داده 10 کیلوبایت است. | فیلدها |  |  organizations[].costCenter |  string | مرکز هزینه سازمان کاربر. |  |  organizations[].customType |  string | اگر مقدار نوع سفارشی باشد، این ویژگی حاوی نوع سفارشی است. |  |  organizations[].department |  string | بخش درون سازمان را مشخص می کند، مانند salesیاengineering. |  |  organizations[].description |  string | شرح سازمان. |  |  organizations[].domain |  string | دامنه ای که سازمان به آن تعلق دارد. |  |  organizations[].fullTimeEquivalent |  integer | میلی درصد معادل تمام وقت در سازمان (100000 = 100%). |  |  organizations[].location |  string | موقعیت فیزیکی سازمان لازم نیست این آدرس کاملاً واجد شرایط باشد. |  |  organizations[].name |  string | نام سازمان. |  |  organizations[].primary |  boolean | نشان می دهد که آیا این سازمان اصلی کاربر است یا خیر. یک کاربر ممکن است فقط یک سازمان اصلی داشته باشد. |  |  organizations[].symbol |  string | نماد رشته متنی سازمان. به عنوان مثال، نماد متنی برای Google GOOGاست. |  |  organizations[].title |  string | عنوان کاربر در سازمان. به عنوان مثال، memberیاengineer. |  |  organizations[].type |  string | نوع سازمان. 
 مقادیر قابل قبول:
 domain_only،school،unknown،work. | 
 | 
| lastLoginTime |  string  فقط خروجی آخرین باری که کاربر وارد حساب کاربری خود شده است. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZDاست. به عنوان مثال،2010-04-05T17:30:04+01:00. | 
| phones |  value ( Valueformat)  لیستی از شماره تلفن های کاربر. حداکثر اندازه مجاز داده 1 کیلوبایت است. | فیلدها |  |  phones[].customType |  string | اگر typeشماره تلفنcustomاست، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  phones[].primary |  boolean | اگر true، این شماره تلفن اصلی کاربر است. یک کاربر ممکن است فقط یک شماره تلفن اصلی داشته باشد. |  |  phones[].type |  string | نوع شماره تلفن. اگر روی customتنظیم شود،customTypeنیز باید تنظیم شود.
 مقادیر قابل قبول:
 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 | یک شماره تلفن قابل خواندن برای انسان. ممکن است در هر قالب شماره تلفنی باشد. | 
 | 
| suspensionReason |  string  فقط خروجی دلیل تعلیق حساب کاربری یا توسط سرپرست یا Google در زمان تعلیق را دارد. اموال فقط در صورتی برگردانده می شود که اموال suspendedtrueباشد. | 
| thumbnailPhotoUrl |  string  فقط خروجی آدرس عکس پروفایل کاربر. URL ممکن است موقت یا خصوصی باشد. | 
| languages |  value ( Valueformat)  لیست زبان های کاربر. حداکثر اندازه مجاز داده 1 کیلوبایت است. | فیلدها |  |  languages[].customLanguage |  string | زبان دیگر. اگر کد زبان ISO 639 مربوطه وجود نداشته باشد، کاربر می تواند نام زبان خود را ارائه دهد. اگر این تنظیم باشد، languageCodeقابل تنظیم نیست. |  |  languages[].languageCode |  string | نمایش رشته ای ISO 639 از یک زبان. برای لیست کدهای پشتیبانی شده به کدهای زبان مراجعه کنید. کدهای زبان معتبر خارج از مجموعه پشتیبانی شده توسط API پذیرفته می شود اما ممکن است منجر به رفتار غیرمنتظره شود. مقادیر غیرقانونی باعث ایجاد SchemaExceptionمی شود. اگر این تنظیم باشد،customLanguageقابل تنظیم نیست. |  |  languages[].preference |  string | اختیاری. در صورت وجود، کنترل میکند که آیا languageCodeمشخصشده زبان ترجیحی کاربر است یا خیر. اگرcustomLanguageتنظیم شده باشد، نمی توان آن را تنظیم کرد. مقادیر مجازpreferredوnot_preferredهستند. | 
 | 
| posixAccounts |  value ( Valueformat)  لیست اطلاعات حساب POSIX برای کاربر. | فیلدها |  |  posixAccounts[].accountId |  string | شناسه فیلد حساب POSIX. |  |  posixAccounts[].gecos |  string | GECOS (اطلاعات کاربر) این حساب. |  |  posixAccounts[].gid |  unsigned long | شناسه پیش فرض گروه |  |  posixAccounts[].homeDirectory |  string | مسیر دایرکتوری اصلی این حساب. |  |  posixAccounts[].operatingSystemType |  string | نوع سیستم عامل برای این حساب. 
 مقادیر قابل قبول:
 linux،unspecified،windows. |  |  posixAccounts[].primary |  boolean | اگر این حساب اصلی کاربر در SystemId باشد. |  |  posixAccounts[].shell |  string | مسیر پوسته ورود به این حساب. |  |  posixAccounts[].systemId |  string | شناسه سیستم که نام کاربری یا Uid برای آن حساب اعمال می شود. |  |  posixAccounts[].uid |  unsigned long | شناسه کاربری سازگار با POSIX. |  |  posixAccounts[].username |  string | نام کاربری اکانت. | 
 | 
| creationTime |  string  فقط خروجی زمانی که حساب کاربری کاربر ایجاد شد. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZDاست. به عنوان مثال،2010-04-05T17:30:04+01:00. | 
| nonEditableAliases[] |  string  فقط خروجی فهرست آدرسهای ایمیل مستعار غیرقابل ویرایش کاربر. اینها معمولاً خارج از دامنه یا زیر دامنه اصلی حساب هستند. | 
| sshPublicKeys |  value ( Valueformat)  لیستی از کلیدهای عمومی SSH | فیلدها |  |  sshPublicKeys[].expirationTimeUsec |  long | زمان انقضا در میکروثانیه از زمان. |  |  sshPublicKeys[].fingerprint |  string | اثر انگشت SHA-256 از کلید عمومی SSH. (فقط خواندنی) |  |  sshPublicKeys[].key |  string | یک کلید عمومی SSH | 
 | 
| notes |  value ( Valueformat)  یادداشت هایی برای کاربر به عنوان یک شی تو در تو. | فیلدها |  |  notes.contentType |  string | نوع محتوای یادداشت، متن ساده یا HTML. پیش فرض متن ساده است. 
 مقادیر قابل قبول:
 text_plain،text_html. |  |  notes.value |  string | محتویات یادداشت ها | 
 | 
| websites |  value ( Valueformat)  لیست وب سایت های کاربر. | فیلدها |  |  websites[].customType |  string | اگر typeوب سایتcustomاست، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  websites[].primary |  boolean | اگر true، این وب سایت اصلی کاربر است. |  |  websites[].type |  string | نوع یا هدف وب سایت. به عنوان مثال، یک وب سایت می تواند به عنوان homeیاblogبرچسب گذاری شود. متناوبا، یک ورودی می تواند یک نوعcustomداشته باشد. اگر رویcustomتنظیم شود،customTypeنیز باید تنظیم شود.
 مقادیر قابل قبول:
 app_install_page،blog،custom،ftp،home،home_page،other،profile،reservations،resume،work. |  |  websites[].value |  string | آدرس وب سایت. | 
 | 
| locations |  value ( Valueformat)  لیست مکان های کاربر. حداکثر اندازه مجاز داده 10 کیلوبایت است. | فیلدها |  |  locations[].area |  string | موقعیت متنی این برای اهداف نمایش برای توصیف مختصر مکان بسیار مفید است. برای مثال، Mountain View, CAیاNear Seattle. |  |  locations[].buildingId |  string | شناسه ساختمان |  |  locations[].customType |  string | اگر typeمکانcustomاست، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  locations[].deskCode |  string | خاص ترین کد متنی مکان میز فردی. |  |  locations[].floorName |  string | نام / شماره طبقه |  |  locations[].floorSection |  string | بخش طبقه. مکان مشخص تر در طبقه به عنوان مثال، اگر یک طبقه به بخش های A،BوCتقسیم شود، این قسمت یکی از آن مقادیر را مشخص می کند. |  |  locations[].type |  string | نوع مکان اگر روی customتنظیم شود،customTypeنیز باید تنظیم شود.
 مقادیر قابل قبول:
 custom،default،desk. | 
 | 
| includeInGlobalAddressList |  boolean  نشان می دهد که نمایه کاربر در فهرست آدرس جهانی Google Workspace زمانی که ویژگی اشتراک گذاری مخاطب برای دامنه فعال است، قابل مشاهده است یا خیر. برای اطلاعات بیشتر درباره حذف نمایههای کاربر، به مرکز راهنمایی مدیریت مراجعه کنید. | 
| keywords |  value ( Valueformat)  لیست کلمات کلیدی کاربر. حداکثر اندازه مجاز داده 1 کیلوبایت است. | فیلدها |  |  keywords[].customType |  string | اگر typeکلمه کلیدیcustomباشد، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  keywords[].type |  string | هر ورودی می تواند یک نوع داشته باشد که نوع استاندارد آن ورودی را نشان می دهد. 
 به عنوان مثال، کلمه کلیدی می تواند از نوع
 occupationیاoutlookباشد. علاوه بر نوع استاندارد، یک ورودی می تواند یک نوعcustomداشته باشد و می تواند هر نامی به آن بدهد. اگر رویcustomتنظیم شود،customTypeنیز باید تنظیم شود.
 ارزش های قابل قبول:
 custom،mission،occupation،outlook. |  |  keywords[].value |  string | کلمه کلیدی | 
 | 
| deletionTime |  string  فقط خروجی زمانی که حساب کاربری کاربر حذف شد. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZDاست. به عنوان مثال2010-04-05T17:30:04+01:00. | 
| gender |  value ( Valueformat)  یک شی تودرتو حاوی جنسیت کاربر. حداکثر اندازه مجاز داده برای این فیلد 1 کیلوبایت است. | فیلدها |  |  gender.addressMeAs |  string | یک رشته قابل خواندن برای انسان که حاوی روش مناسب برای ارجاع به مالک نمایه توسط انسان است، برای مثال «او/او/او» یا «آنها/آنها/آنها». |  |  gender.customGender |  string | نام جنسیت سفارشی |  |  gender.type |  string | نوع جنسیت. 
 ارزش های قابل قبول:
  female male other unknown
 | 
 | 
| thumbnailPhotoEtag |  string  فقط خروجی ETag عکس کاربر (فقط خواندنی) | 
| ims |  value ( Valueformat)  حسابهای پیامرسان فوری (IM) کاربر. یک حساب کاربری میتواند چندین ویژگی imsداشته باشد، اما تنها یکی از این ویژگیهایimsمیتواند مخاطب اولیه IM باشد. | فیلدها |  |  ims[].customProtocol |  string | اگر مقدار پروتکل custom_protocolباشد، این ویژگی رشته پروتکل سفارشی را نگه می دارد. |  |  ims[].customType |  string | اگر typeIMcustomاست، این ویژگی حاوی مقدار سفارشی است و باید تنظیم شود. |  |  ims[].im |  string | شناسه شبکه IM کاربر. |  |  ims[].primary |  boolean | اگر این پیام فوری اولیه کاربر باشد. فقط یک ورودی در لیست IM می تواند مقدار true داشته باشد. |  |  ims[].protocol |  string | یک پروتکل IM شبکه IM را شناسایی می کند. مقدار می تواند یک شبکه سفارشی یا شبکه استاندارد باشد. 
 ارزش های قابل قبول:
  aim: پروتکل AOL Instant Messenger custom_protocol: یک پروتکل شبکه IM سفارشی gtalk: پروتکل Google Talk icq: پروتکل ICQ jabber: پروتکل Jabber msn: پروتکل MSN Messenger net_meeting: پروتکل Net Meeting qq: پروتکل QQ skype: پروتکل اسکایپ yahoo: پروتکل یاهو مسنجر
 |  |  ims[].type |  string | نوع حساب IM. اگر روی customتنظیم شود،customTypeنیز باید تنظیم شود.
 ارزش های قابل قبول:
 custom،home،other،work. | 
 | 
| customSchemas |  value ( Valueformat)  فیلدهای سفارشی کاربر کلید یک schemaNameاست و مقادیر آن'fieldName': 'field_value'است.  customSchemas.(key)یک شی تودرتو است. customSchemas.(key).(key)می تواند هر مقداری باشد.
 | 
| isEnrolledIn2Sv |  boolean  فقط خروجی در راستیآزمایی ۲ مرحلهای (فقط خواندنی) ثبتنام شده است | 
| isEnforcedIn2Sv |  boolean  فقط خروجی آیا راستیآزمایی ۲مرحلهای اجرا میشود (فقط خواندنی) | 
| archived |  boolean  نشان می دهد که آیا کاربر بایگانی شده است یا خیر. | 
| orgUnitPath |  string  مسیر کامل سازمان مادر مرتبط با کاربر. اگر سازمان مادر در سطح بالا باشد، به صورت اسلش رو به جلو ( /) نشان داده می شود. | 
| recoveryEmail |  string  ایمیل بازیابی کاربر | 
| recoveryPhone |  string  تلفن ریکاوری کاربر شماره تلفن باید در قالب E.164 باشد و با علامت مثبت (+) شروع شود. مثال: +16506661212 .  |