משאב: משתמש
Directory API מאפשר ליצור ולנהל את המשתמשים, כינויי המשתמשים ותמונות הפרופיל של המשתמשים בחשבון. מידע נוסף על משימות נפוצות זמין במדריך למפתחים בנושא חשבונות משתמשים ובמדריך למפתחים בנושא כינויים של משתמשים.
ייצוג ב-JSON |
---|
{
"id": string,
"primaryEmail": string,
"password": value,
"hashFunction": string,
"isAdmin": boolean,
"isDelegatedAdmin": boolean,
"agreedToTerms": boolean,
"suspended": boolean,
"changePasswordAtNextLogin": boolean,
"ipWhitelisted": boolean,
"name": {
object ( |
שדות | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
המזהה הייחודי של המשתמש. אפשר להשתמש במשתמש |
||||||||||||||||||||||||||||||||||||||||||
primaryEmail |
כתובת האימייל הראשית של המשתמש. המאפיין הזה נדרש בבקשה ליצירת חשבון משתמש. השם |
||||||||||||||||||||||||||||||||||||||||||
password |
אחסון הסיסמה של חשבון המשתמש. צריך לציין את ערך הסיסמה של המשתמש כשיוצרים חשבון משתמש. השדה הזה הוא אופציונלי בזמן עדכון משתמש, וצריך לספק אותו רק אם המשתמש מעדכן את הסיסמה לחשבון שלו. ערך הסיסמה אף פעם לא מוחזר בגוף התגובה של ה-API. |
||||||||||||||||||||||||||||||||||||||||||
hashFunction |
מאגר של פורמט הגיבוב של המאפיין
אם מציינים עיגולים כחלק מהקידומת, הם צריכים להיות באורך 10,000 או פחות. |
||||||||||||||||||||||||||||||||||||||||||
isAdmin |
פלט בלבד. מציין משתמש עם הרשאות של סופר-אדמין. אפשר לערוך את המאפיין |
||||||||||||||||||||||||||||||||||||||||||
isDelegatedAdmin |
פלט בלבד. מציין אם המשתמש הוא אדמין שהוקצו לו הרשאות. |
||||||||||||||||||||||||||||||||||||||||||
agreedToTerms |
פלט בלבד. הערך של המאפיין הזה הוא |
||||||||||||||||||||||||||||||||||||||||||
suspended |
שדה זה מציין אם המשתמש מושעה. |
||||||||||||||||||||||||||||||||||||||||||
changePasswordAtNextLogin |
מציין אם המשתמש נדרש לשנות את הסיסמה בכניסה הבאה. ההגדרה הזו לא חלה כשהמשתמש נכנס דרך ספק זהויות של צד שלישי. |
||||||||||||||||||||||||||||||||||||||||||
ipWhitelisted |
אם הערך שלו הוא |
||||||||||||||||||||||||||||||||||||||||||
name |
מאפיין שמכיל את השם הפרטי ושם המשפחה של המשתמש ואת הערך |
||||||||||||||||||||||||||||||||||||||||||
kind |
פלט בלבד. הסוג של משאב ה-API. במשאבי Users, הערך הוא |
||||||||||||||||||||||||||||||||||||||||||
etag |
פלט בלבד. ה-ETag של המשאב. |
||||||||||||||||||||||||||||||||||||||||||
emails |
רשימת כתובות האימייל של המשתמש. הגודל המקסימלי של הנתונים הוא 10KB.
|
||||||||||||||||||||||||||||||||||||||||||
externalIds |
רשימת המזהים החיצוניים של המשתמש, כמו עובד או מזהה רשת. הגודל המקסימלי של הנתונים הוא 2KB.
|
||||||||||||||||||||||||||||||||||||||||||
relations |
רשימת היחסים של המשתמש עם משתמשים אחרים. הגודל המקסימלי של הנתונים בשדה הזה הוא 2KB. מידע נוסף זמין במאמר ניהול חשבונות משתמשים.
|
||||||||||||||||||||||||||||||||||||||||||
aliases[] |
פלט בלבד. רשימת כתובות האימייל החלופיות של המשתמש. |
||||||||||||||||||||||||||||||||||||||||||
isMailboxSetup |
פלט בלבד. מציין אם תיבת הדואר של המשתמש ב-Google נוצרה. המאפיין הזה רלוונטי רק אם למשתמש הוקצה רישיון ל-Gmail. |
||||||||||||||||||||||||||||||||||||||||||
customerId |
פלט בלבד. מספר הלקוח כדי לאחזר את כל המשתמשים בחשבון. |
||||||||||||||||||||||||||||||||||||||||||
addresses |
רשימת הכתובות של המשתמש. הגודל המקסימלי של הנתונים הוא 10KB.
|
||||||||||||||||||||||||||||||||||||||||||
organizations |
רשימת הארגונים שהמשתמש שייך אליהם. גודל הנתונים המקסימלי הוא 10KB.
|
||||||||||||||||||||||||||||||||||||||||||
lastLoginTime |
פלט בלבד. הפעם האחרונה שבה המשתמש נכנס לחשבון המשתמש. הערך הוא בפורמט תאריך ושעה לפי התקן ISO 8601. הזמן הוא התאריך המלא בתוספת שעות, דקות ושניות בפורמט |
||||||||||||||||||||||||||||||||||||||||||
phones |
רשימה של מספרי הטלפון של המשתמש. הגודל המקסימלי של הנתונים הוא 1KB.
|
||||||||||||||||||||||||||||||||||||||||||
suspensionReason |
פלט בלבד. הסיבה לכך שחשבון המשתמש הושעה על ידי האדמין או על ידי Google בזמן ההשעיה. המאפיין מוחזר רק אם המאפיין |
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoUrl |
פלט בלבד. כתובת ה-URL של תמונת הפרופיל של המשתמש. יכול להיות שכתובת ה-URL היא זמנית או פרטית. |
||||||||||||||||||||||||||||||||||||||||||
languages |
רשימת השפות של המשתמש. הגודל המקסימלי של הנתונים הוא 1KB.
|
||||||||||||||||||||||||||||||||||||||||||
posixAccounts |
רשימת פרטי החשבון של המשתמש ב-POSIX.
|
||||||||||||||||||||||||||||||||||||||||||
creationTime |
פלט בלבד. המועד שבו נוצר החשבון של המשתמש. הערך הוא בפורמט תאריך ושעה לפי תקן ISO 8601. הזמן הוא התאריך המלא בתוספת שעות, דקות ושניות בפורמט |
||||||||||||||||||||||||||||||||||||||||||
nonEditableAliases[] |
פלט בלבד. רשימת כתובות האימייל החלופיות של המשתמש שלא ניתן לערוך. בדרך כלל, הן נמצאות מחוץ לדומיין הראשי או לדומיין המשנה של החשבון. |
||||||||||||||||||||||||||||||||||||||||||
sshPublicKeys |
רשימה של מפתחות SSH ציבוריים.
|
||||||||||||||||||||||||||||||||||||||||||
notes |
הערות למשתמש כאובייקט בתצוגת עץ.
|
||||||||||||||||||||||||||||||||||||||||||
websites |
רשימת האתרים של המשתמש.
|
||||||||||||||||||||||||||||||||||||||||||
locations |
רשימת המיקומים של המשתמש. הגודל המקסימלי של הנתונים הוא 10KB.
|
||||||||||||||||||||||||||||||||||||||||||
includeInGlobalAddressList |
האפשרות הזו מציינת אם הפרופיל של המשתמש גלוי ברשימת הכתובות הגלובלית של Google Workspace כשהתכונה 'שיתוף אנשי קשר' מופעלת בדומיין. למידע נוסף על החרגת פרופילים של משתמשים, ניתן להיכנס למרכז העזרה בנושא ניהול. |
||||||||||||||||||||||||||||||||||||||||||
keywords |
רשימת מילות המפתח של המשתמש. הגודל המקסימלי של הנתונים הוא 1KB.
|
||||||||||||||||||||||||||||||||||||||||||
deletionTime |
פלט בלבד. המועד שבו חשבון המשתמש נמחק. הערך מופיע בפורמט תאריך ושעה לפי ISO 8601. הזמן הוא התאריך המלא בתוספת שעות, דקות ושניות בפורמט |
||||||||||||||||||||||||||||||||||||||||||
gender |
אובייקט בתצוגת עץ שמכיל את המגדר של המשתמש. הגודל המקסימלי של הנתונים שאפשר להזין בשדה הזה הוא 1KB.
|
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoEtag |
פלט בלבד. תג E של תמונת המשתמש (קריאה בלבד) |
||||||||||||||||||||||||||||||||||||||||||
ims |
חשבונות Instant Messenger (IM) של המשתמש. לחשבון משתמש יכולים להיות כמה נכסי
|
||||||||||||||||||||||||||||||||||||||||||
customSchemas |
שדות מותאמים אישית של המשתמש. המפתח הוא
|
||||||||||||||||||||||||||||||||||||||||||
isEnrolledIn2Sv |
פלט בלבד. הרשמה לאימות דו-שלבי (קריאה בלבד) |
||||||||||||||||||||||||||||||||||||||||||
isEnforcedIn2Sv |
פלט בלבד. האם האימות הדו-שלבי נאכף (לקריאה בלבד) |
||||||||||||||||||||||||||||||||||||||||||
archived |
מציין אם המשתמש הועבר לארכיון. |
||||||||||||||||||||||||||||||||||||||||||
orgUnitPath |
הנתיב המלא של הארגון ההורה שמשויך למשתמש. אם הארגון ההורה הוא ברמה העליונה, הוא מיוצג על ידי קו נטוי קדימה ( |
||||||||||||||||||||||||||||||||||||||||||
recoveryEmail |
כתובת האימייל לשחזור החשבון של המשתמש. |
||||||||||||||||||||||||||||||||||||||||||
recoveryPhone |
טלפון השחזור של המשתמש. מספר הטלפון חייב להיות בפורמט E.164, ולהתחיל בסימן פלוס (+). דוגמה: +16506661212. |
UserName
ייצוג ב-JSON |
---|
{ "fullName": string, "familyName": string, "givenName": string, "displayName": string } |
שדות | |
---|---|
fullName |
השם המלא של המשתמש, שנוצר על ידי שרשור הערכים של השם הפרטי ושם המשפחה. |
familyName |
שם המשפחה של המשתמש. חובה כשיוצרים חשבון משתמש. |
givenName |
השם הפרטי של המשתמש. חובה כשיוצרים חשבון משתמש. |
displayName |
השם המוצג של המשתמש. מגבלה: 256 תווים. |
שיטות |
|
---|---|
|
מחיקה של משתמש. |
|
אחזור משתמש. |
|
יצירת משתמש. |
|
אחזור רשימה מחולקת של משתמשים שנמחקו או כל המשתמשים בדומיין. |
|
הופכת משתמש לסופר-אדמין. |
|
עדכון משתמש באמצעות סמנטיקה של תיקונים. |
|
היציאה מכל הסשנים באינטרנט ובמכשיר ואיפוס קובצי ה-cookie של הכניסה. |
|
ביטול המחיקה של משתמש שנמחק. |
|
מעדכן משתמש. |
|
עוקב אחרי שינויים ברשימת המשתמשים. |