إنشاء عميل
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لإنشاء عنصر Company
لتحديد شركة (عميل) بشكل فريد من أجل تسجيل Knox أو تسجيل
بلمسة واحدة. بعد نجاح الطريقة، يمكن للمالكين المحدّدين (primary_emails)
أو المشرفين (secondary_emails) ربط عناوين بريدهم الإلكتروني بحساب Google
للوصول إلى بوابة عملاء برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة"
(للاطّلاع على التفاصيل، راجِع إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة لمشرفي تكنولوجيا المعلومات)
أو حساب Samsung للوصول إلى بوابة Knox Mobile Enrollment (KME).
توقيع الطريقة
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| اسم الموقع |
القيمة |
مطلوب |
الوصف |
customer_name |
string |
نعم |
اسم الشركة على سبيل المثال، شركة XYZ. يتم عرضها لموظفي الشركة في منصة إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة. |
primary_emails |
تمثّل هذه السمة قائمة object(string). |
نعم |
إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة: عنوان البريد الإلكتروني لمستخدمي العميل في دور المالك. يجب إدخال عنوان بريد إلكتروني واحد على الأقل. يجب ربط كل عنوان بريد إلكتروني بحساب على Google. يحصل المالكون على إذن الوصول نفسه مثل المشرفين، ولكن يمكنهم أيضًا إضافة مستخدمي بوابة مؤسستك وحذفهم وتعديلهم.
Samsung: عنوان البريد الإلكتروني للمشرف المتميّز للعميل. لا تأخذ Samsung سوى البريد الإلكتروني الأول في القائمة. يجب أن يكون عنوان البريد الإلكتروني مرتبطًا بحساب Samsung. |
secondary_emails |
تمثّل هذه السمة قائمة object(string). |
لا |
عنوان البريد الإلكتروني لمستخدمي العميل الذين لديهم دور المشرف. يجب ربط كل عنوان بريد إلكتروني بحساب على Google. ملاحظة: لا تتيح Samsung هذا الخيار. |
vendorParams |
map |
إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة: لا
Samsung: نعم |
الحقول الإضافية، زوج المفتاح/القيمة المحدّد من المورّد يجب أن تحدّد الطلبات الواردة من فئة SamsungResellerService ما يلي:
"country": رمز بلد ISO 3166-1 للعميل، على سبيل المثال "US".
"firstName": الاسم الأول للعميل (60 حرفًا بحد أقصى).
"lastName": اسم العائلة للعميل (60 حرفًا بحد أقصى).
"service": "KME" هي القيمة الوحيدة المسموح بها. |
CreateCustomerResponse
| اسم الموقع |
القيمة |
الوصف |
customer |
object(Company) |
عنصر يحتوي على تفاصيل العميل الذي تم إنشاؤه حديثًا. |
vendor_params |
map |
الحقول الإضافية، زوج المفتاح/القيمة المحدَّد من المورِّد (Samsung فقط) |
سلوك الخطأ
في حال حدوث خطأ، تُرسِل المكتبة CommonException يحتوي على أحد رمزَي الخطأ التاليَين:
CommonException
| رمز الخطأ |
INTERNAL_SERVER_ERROR |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis process creates a \u003ccode\u003eCompany\u003c/code\u003e object to uniquely identify a customer for Knox or zero-touch enrollment.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecustomer_name\u003c/code\u003e, \u003ccode\u003eprimary_emails\u003c/code\u003e, and \u003ccode\u003evendorParams\u003c/code\u003e are required parameters for creating a customer, and \u003ccode\u003esecondary_emails\u003c/code\u003e is optional.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eprimary_emails\u003c/code\u003e are email addresses for owners (for zero-touch) or super admins (for Samsung), who can access the zero-touch or Knox Mobile Enrollment portal, and must be associated with a Google Account or Samsung Account, respectively.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esecondary_emails\u003c/code\u003e represent admin users for zero-touch enrollment, must be associated with a Google Account, and are not supported by Samsung.\u003c/p\u003e\n"],["\u003cp\u003eThe method throws a \u003ccode\u003eCommonException\u003c/code\u003e with an \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e if an issue occurs during customer creation.\u003c/p\u003e\n"]]],["This document outlines how to create a `Company` object to identify a customer for Knox or zero-touch enrollment. The `createCustomer` method requires a company name and a list of primary email addresses (owners/super admins). Secondary email addresses (admins) are optional for zero-touch. Samsung requests also need `vendorParams`, specifying country, first name, last name, and \"KME\" service. Successful creation returns a `Company` object, allowing associated emails access to the zero-touch or KME portal. Errors result in a `CommonException`.\n"],null,["Creates a [`Company`](/zero-touch/reseller-library/reference/objects#company)\nobject to uniquely identify a company (customer) for Knox or zero-touch\nenrollment. After the method returns successfully, the specified owners (`primary_emails`)\nor admins (`secondary_emails`) can associate their email addresses with a Google\nAccount to access the [zero touch customer portal](https://enterprise.google.com/android/zero-touch/customers)\n(for details, see [Zero-touch enrollment for IT admins](https://support.google.com/work/android/answer/7514005))\nor a Samsung Account to access the Knox Mobile Enrollment (KME) portal.\n\nMethod signature \n\n public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;\n\nCreateCustomerRequest\n\n| Property name | Value | Required | Description |\n|--------------------|--------------------------|-------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer_name` | `string` | Yes | The name of the company. For example XYZ Corp. Displayed to the company's employees in the zero-touch enrollment portal. |\n| `primary_emails` | List of `object(string)` | Yes | **Zero-touch:** Email address of customer's users in the owner role. At least one email address is required. Each email address must be associated with a Google Account. Owners share the same access as admins but can also add, delete, and edit your organization's portal users. **Samsung:** Email address of customer's super admin. Samsung only takes the first email in the list. Email address must be associated with a Samsung Account. |\n| `secondary_emails` | List of `object(string)` | No | Email address of customer's users in the admin role. Each email address must be associated with a Google Account. **Note:** This property is not supported by Samsung. |\n| `vendorParams` | `map` | **Zero-touch:** No **Samsung:** Yes | Extra fields, vendor specified key-value pair. Requests from the `SamsungResellerService` class must specify: \"country\": [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the customer, for example \"US\". \"firstName\": first name of the customer (max. 60 characters). \"lastName\": last name of the customer (max. 60 characters). \"service\": \"KME\" is the only supported value. |\n\nCreateCustomerResponse\n\n| Property name | Value | Description |\n|-----------------|---------------------------------------------------------------------------------|---------------------------------------------------------------|\n| `customer` | `object(`[`Company`](/zero-touch/reseller-library/reference/objects#company)`)` | Object containing details of the newly created customer. |\n| `vendor_params` | `map` | Extra fields, vendor specified key-value pair (Samsung only). |\n\nError behavior\n\nIf an error occurs, the library throws a `CommonException` containing one of the\nfollowing error codes:\n\n`CommonException`\n\n| Error code |\n|-------------------------|\n| `INTERNAL_SERVER_ERROR` |"]]
