Method: users.insert

יוצר משתמש.

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
resolveConflictAccount

boolean

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

גוף הבקשה

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

גוף התשובה

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

היקפי ההרשאות

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

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

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