משאב: משתמש
באמצעות 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 |
חשבונות האימייל המיידי (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 תווים. |
Methods |
|
---|---|
|
מחיקה של משתמש. |
|
אחזור משתמש. |
|
יצירת משתמש. |
|
אחזור רשימה מחולקת לדפים של משתמשים שנמחקו או של כל המשתמשים בדומיין. |
|
הקצאת תפקיד סופר-אדמין למשתמש. |
|
עדכון משתמש באמצעות סמנטיקה של תיקון. |
|
המערכת מוציאה את המשתמש מכל הסשנים באינטרנט ובמכשיר ומאפסת את קובצי ה-Cookie של פרטי הכניסה שלו. |
|
ביטול המחיקה של משתמש שנמחק. |
|
עדכון משתמש. |
|
מעקב אחרי שינויים ברשימת המשתמשים. |