משאב: משתמש
Directory API מאפשר לכם ליצור ולנהל את המשתמשים בחשבון, את הכינויים של המשתמשים ואת תמונות הפרופיל של המשתמשים ב-Google. מידע נוסף על משימות נפוצות זמין במדריך למפתחים בנושא חשבונות משתמשים ובמדריך למפתחים בנושא כינויי משתמשים.
| ייצוג ב-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 |
פלט בלבד. תג ETag של תמונת המשתמש (קריאה בלבד) |
||||||||||||||||||||||||||||||||||||||||||
ims |
החשבונות של המשתמש בתוכנות מסרים מיידיים (IM). לחשבון משתמש יכולים להיות כמה
|
||||||||||||||||||||||||||||||||||||||||||
customSchemas |
שדות מותאמים אישית של המשתמש. המפתח הוא
|
||||||||||||||||||||||||||||||||||||||||||
isEnrolledIn2Sv |
פלט בלבד. רשום לאימות דו-שלבי (קריאה בלבד) |
||||||||||||||||||||||||||||||||||||||||||
isEnforcedIn2Sv |
פלט בלבד. האם נאכף אימות דו-שלבי (קריאה בלבד) |
||||||||||||||||||||||||||||||||||||||||||
archived |
מציין אם המשתמש הועבר לארכיון. |
||||||||||||||||||||||||||||||||||||||||||
orgUnitPath |
הנתיב המלא של הארגון ברמת ההורה שמשויך למשתמש. אם הארגון ברמה העליונה הוא ארגון האב, הוא מיוצג באמצעות קו נטוי לפנים ( |
||||||||||||||||||||||||||||||||||||||||||
recoveryEmail |
כתובת האימייל לשחזור החשבון של המשתמש. |
||||||||||||||||||||||||||||||||||||||||||
recoveryPhone |
מספר טלפון לשחזור חשבון של המשתמש. מספר הטלפון חייב להיות בפורמט E.164, שמתחיל בסימן הפלוס (+). דוגמה: +16506661212. |
||||||||||||||||||||||||||||||||||||||||||
isGuestUser |
אי אפשר לשנות. מציין אם המשתמש הוא אורח. |
||||||||||||||||||||||||||||||||||||||||||
guestAccountInfo |
אי אפשר לשנות. שדות נוספים של מטא-נתונים שקשורים לאורחים |
||||||||||||||||||||||||||||||||||||||||||
UserName
| ייצוג ב-JSON |
|---|
{ "fullName": string, "familyName": string, "givenName": string, "displayName": string } |
| שדות | |
|---|---|
fullName |
השם המלא של המשתמש שנוצר משרשור של ערכי השם הפרטי ושם המשפחה. |
familyName |
שם המשפחה של המשתמש. נדרש כשיוצרים חשבון משתמש. |
givenName |
השם הפרטי של המשתמש. נדרש כשיוצרים חשבון משתמש. |
displayName |
השם המוצג של המשתמש. מכסה: 256 תווים. |
GuestAccountInfo
פרטי החשבון הספציפיים למשתמשים אורחים.
| ייצוג ב-JSON |
|---|
{ "primaryGuestEmail": string } |
| שדות | |
|---|---|
primaryGuestEmail |
אי אפשר לשנות. כתובת האימייל החיצונית של האורח. |
Methods |
|
|---|---|
|
ליצור משתמש אורח עם גישה לקבוצת משנה של יכולות Workspace. |
|
מחיקת משתמש. |
|
שליפת משתמש. |
|
יצירת משתמש. |
|
מאחזר רשימה עם חלוקה לדפים של משתמשים שנמחקו או של כל המשתמשים בדומיין. |
|
הופכים משתמש לסופר-אדמין. |
|
מעדכן משתמש באמצעות סמנטיקה של תיקון. |
|
מוציא את המשתמש מכל הסשנים באינטרנט ובמכשירים ומאפס את קובצי ה-Cookie של פרטי הכניסה שלו. |
|
מבטל את המחיקה של משתמש שנמחק. |
|
עדכון משתמש. |
|
הפונקציה עוקבת אחרי שינויים ברשימת המשתמשים. |