Method: users.insert
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
کاربر ایجاد می کند.
جهش تماس‌ها بلافاصله پس از ایجاد کاربر ممکن است گاهی اوقات با شکست مواجه شوند زیرا کاربر به طور کامل ایجاد نشده است به دلیل تأخیر انتشار در backend ما. جزئیات خطا را برای پیام "ساخت کاربر کامل نیست" بررسی کنید تا ببینید آیا این مورد است. امتحان مجدد تماس ها بعد از مدتی می تواند در این مورد کمک کننده باشد.
اگر resolveConflictAccount روی true تنظیم شود، یک کد پاسخ 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
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: users.insert\n\nCreates a user.\n\nMutate calls immediately following user creation might sometimes fail as the user isn't fully created due to propagation delay in our backends. Check the error details for the \"User creation is not complete\" message to see if this is the case. Retrying the calls after some time can help in this case.\n\nIf `resolveConflictAccount` is set to `true`, a `202` response code means that a conflicting unmanaged account exists and was invited to join the organization. A `409` response code means that a conflicting account exists so the user wasn't created based on the [handling unmanaged user accounts](https://support.google.com/a/answer/11112794) option selected.\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/users`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `resolveConflictAccount` | `boolean` Optional. If set to `true`, the option selected for [handling unmanaged user accounts](https://support.google.com/a/answer/11112794) will apply. Default: `false` |\n\n### Request body\n\nThe request body contains an instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.user`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
