Method: users.insert

یک کاربر ایجاد می‌کند.

ممکن است فراخوانی‌های تغییر بلافاصله پس از ایجاد کاربر، گاهی اوقات با شکست مواجه شوند، زیرا کاربر به دلیل تأخیر انتشار در backendهای ما به طور کامل ایجاد نشده است. جزئیات خطای پیام "ایجاد کاربر کامل نشده است" را بررسی کنید تا ببینید آیا این مورد وجود دارد یا خیر. در این مورد، تلاش مجدد برای فراخوانی‌ها پس از مدتی می‌تواند مفید باشد.

اگر resolveConflictAccount روی true تنظیم شده باشد، گزینه انتخاب شده برای یافتن و اضافه کردن کاربران مدیریت نشده برای حل مشکل حساب‌های کاربری دارای تداخل اعمال خواهد شد:

  • کد پاسخ 200 نشان می‌دهد که کاربر ایجاد شده است (یا جایگزین یک حساب شخصی مدیریت نشده موجود شده است).
  • کد پاسخ 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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.