Method: users.insert

יצירת משתמש.

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

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

בקשת HTTP

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

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

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

פרמטרים
resolveConflictAccount

boolean

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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