creaCliente
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea un oggetto Company per identificare in modo univoco un'azienda (cliente) per la registrazione Knox o zero-touch. Una volta che il metodo restituisce un risultato positivo, i proprietari (primary_emails) o gli amministratori (secondary_emails) specificati possono associare i propri indirizzi email a un Account Google per accedere al portale dei clienti zero-touch (per maggiori dettagli, consulta Registrazione zero-touch per gli amministratori IT) o a un Account Samsung per accedere al portale Knox Mobile Enrollment (KME).
Firma del metodo
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| Nome proprietà |
Valore |
Obbligatorio |
Descrizione |
customer_name |
string |
Sì |
Il nome dell'azienda. Ad esempio, XYZ Corp. viene mostrato ai dipendenti dell'azienda nel portale di registrazione zero-touch. |
primary_emails |
Elenco di object(string) |
Sì |
Zero-touch:indirizzo email degli utenti del cliente nel ruolo di proprietario. È necessario almeno un indirizzo email. Ogni indirizzo email deve essere associato a un Account Google. I proprietari condividono lo stesso accesso degli amministratori, ma possono anche aggiungere, eliminare e modificare gli utenti del portale della tua organizzazione.
Samsung: indirizzo email del super amministratore del cliente. Samsung prende solo la prima email nell'elenco. L'indirizzo email deve essere associato a un account Samsung. |
secondary_emails |
Elenco di object(string) |
No |
Indirizzo email degli utenti del cliente nel ruolo di amministratore. Ogni indirizzo email deve essere associato a un Account Google. Nota:questa proprietà non è supportata da Samsung. |
vendorParams |
map |
Zero-touch: No
Samsung: Sì |
Campi aggiuntivi, coppia chiave-valore specificata dal fornitore. Le richieste della classe SamsungResellerService devono specificare:
"country": codice paese ISO 3166-1 del cliente, ad esempio "US".
"firstName": nome del cliente (massimo 60 caratteri).
"lastName": cognome del cliente (massimo 60 caratteri).
"service": "KME" è l'unico valore supportato. |
CreateCustomerResponse
| Nome proprietà |
Valore |
Descrizione |
customer |
object(Company) |
Oggetto contenente i dettagli del cliente appena creato. |
vendor_params |
map |
Campi aggiuntivi, coppia chiave-valore specificata dal fornitore (solo Samsung). |
Comportamento in caso di errore
Se si verifica un errore, la libreria genera un CommonException contenente uno dei seguenti codici di errore:
CommonException
| Codice di errore |
INTERNAL_SERVER_ERROR |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[[["\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` |"]]
