ایجاد مشتری
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک شی Company برای شناسایی منحصر به فرد یک شرکت (مشتری) برای ثبت نام Knox یا zero-touch ایجاد می کند. پس از بازگشت موفقیت آمیز روش، مالکان مشخص شده ( primary_emails ) یا سرپرستان ( secondary_emails ) می توانند آدرس ایمیل خود را با یک حساب Google مرتبط کنند تا به پورتال مشتری zero touch دسترسی داشته باشند (برای جزئیات، به ثبت نام Zero-touch برای مدیران فناوری اطلاعات مراجعه کنید) یا یک حساب Samsung برای دسترسی به پورتال Knox Mobile Enrollment (KME).
امضای روش
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| نام ملک | ارزش | مورد نیاز | توضیحات |
|---|
customer_name | string | بله | نام شرکت. به عنوان مثال XYZ Corp. در پورتال ثبت نام بدون لمس برای کارمندان شرکت نمایش داده می شود. |
primary_emails | فهرست object(string) | بله | لمس صفر: آدرس ایمیل کاربران مشتری در نقش مالک. حداقل یک آدرس ایمیل مورد نیاز است. هر آدرس ایمیل باید با یک حساب Google مرتبط باشد. مالکان دسترسی مشابهی با مدیران دارند، اما همچنین می توانند کاربران پورتال سازمان شما را اضافه، حذف و ویرایش کنند.
سامسونگ: آدرس ایمیل سوپر ادمین مشتری. سامسونگ فقط اولین ایمیل لیست را دریافت می کند. آدرس ایمیل باید با یک حساب سامسونگ مرتبط باشد. |
secondary_emails | فهرست object(string) | خیر | آدرس ایمیل کاربران مشتری در نقش ادمین. هر آدرس ایمیل باید با یک حساب Google مرتبط باشد. توجه: این ویژگی توسط سامسونگ پشتیبانی نمی شود. |
vendorParams | map | لمس صفر: خیر
سامسونگ: بله | فیلدهای اضافی، جفت کلید-مقدار مشخص شده توسط فروشنده. درخواست‌های کلاس SamsungResellerService باید مشخص کنند:
"کشور": کد کشور مشتری ISO 3166-1 ، به عنوان مثال "US".
"firstName": نام مشتری (حداکثر 60 کاراکتر).
"LastName": نام خانوادگی مشتری (حداکثر 60 کاراکتر).
"service": "KME" تنها مقدار پشتیبانی شده است. |
CreateCustomerResponse
| نام ملک | ارزش | توضیحات |
|---|
customer | object( Company ) | شی حاوی جزئیات مشتری تازه ایجاد شده است. |
vendor_params | map | فیلدهای اضافی، جفت کلید-مقدار مشخص شده توسط فروشنده (فقط سامسونگ). |
رفتار خطا
اگر خطایی رخ دهد، کتابخانه یک CommonException حاوی یکی از کدهای خطای زیر می‌فرستد:
CommonException
| کد خطا |
|---|
INTERNAL_SERVER_ERROR |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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,["# createCustomer\n\nCreates 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\n public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;\n\nCreateCustomerRequest\n---------------------\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\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--------------\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` |"]]
