Method: users.insert

تنشئ هذه الطريقة مستخدمًا.

قد تتعذّر أحيانًا طلبات التغيير التي تلي عملية إنشاء المستخدم مباشرةً لأنّ المستخدم لم يتم إنشاؤه بالكامل بسبب تأخّر الانتشار في الأنظمة الخلفية. راجِع تفاصيل الخطأ في الرسالة "لم تكتمل عملية إنشاء المستخدم" لمعرفة ما إذا كان هذا هو السبب. يمكن أن تساعد إعادة محاولة إجراء المكالمات بعد مرور بعض الوقت في هذه الحالة.

إذا تم ضبط resolveConflictAccount على true، سيتم تطبيق الخيار المحدّد في البحث عن مستخدمين غير مُدارين وإضافتهم لحلّ الحسابات المتضاربة:

  • يشير رمز الاستجابة 200 إلى أنّه تم إنشاء المستخدم (أو استبدال حساب شخصي حالي غير مُدار).
  • يشير رمز الاستجابة 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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.