Method: users.insert

יצירת משתמש.

יכול להיות שקריאות לשינוי (mutate) שמתבצעות מיד אחרי יצירת משתמש ייכשלו לפעמים, כי המשתמש לא נוצר באופן מלא בגלל עיכוב בהפצה בשרתי הקצה שלנו. כדי לבדוק אם זה המקרה, צריך לעיין בפרטי השגיאה של ההודעה 'יצירת המשתמש לא הושלמה'. במקרה כזה, כדאי לנסות שוב להתקשר אחרי כמה זמן.

אם הערך של resolveConflictAccount הוא true, האפשרות שנבחרה עבור איתור והוספה של חשבונות לא מנוהלים תחול על פתרון בעיות שנוצרות בגלל חשבונות בעלי מאפיינים זהים לחשבון פעיל:

  • קוד התגובה 200 מציין שהמשתמש נוצר (או החליף חשבון אישי לא מנוהל קיים).
  • קוד התגובה 202 מציין שקיים חשבון אישי לא מנוהל עם מאפיינים זהים לחשבון פעיל, והמשתמש הוזמן להצטרף לארגון.
  • קוד התגובה 409 מציין שקיים חשבון עם שם משתמש זהה, ולכן המשתמש לא נוצר (למשל, בהתאם לאפשרות שנבחרה לשמירת החשבון, או אם כתובת האימייל זהה לכתובת אימייל של חשבון לא מנוהל לצורכי עבודה או של משתמש מנוהל קיים).

לפרטים על פתרון שגיאות שקשורות לחשבונות כפולים, אפשר לעיין במאמרים פתרון שגיאות שקשורות לחשבונות כפולים והעברת חשבונות לא מנוהלים של מקום עבודה.

בקשת HTTP

POST https://admin.googleapis.com/admin/directory/v1/users

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של שאילתה

פרמטרים
resolveConflictAccount

boolean

אופציונלי. האפשרות שנבחרה בהגדרה איתור והוספת חשבונות לא מנוהלים מוחלת כדי לפתור בעיות שנוצרות בגלל חשבונות בעלי מאפיינים זהים לחשבון פעיל, כשההגדרה היא true. ברירת מחדל: false

גוף הבקשה

גוף הבקשה מכיל מופע של User.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של User.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/admin.directory.user

מידע נוסף זמין במדריך ההרשאות.