créerClient
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée un objet Company pour identifier de manière unique une entreprise (client) pour l'enregistrement Knox ou sans contact. Une fois la méthode renvoyée, les propriétaires (primary_emails) ou administrateurs (secondary_emails) spécifiés peuvent associer leurs adresses e-mail à un compte Google pour accéder au portail client sans contact (pour en savoir plus, consultez la section Enregistrement sans contact pour les administrateurs informatiques) ou à un compte Samsung pour accéder au portail KME (Knox Mobile Enrollment).
Signature de méthode
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| Nom de propriété |
Valeur |
Obligatoire |
Description |
customer_name |
string |
Oui |
Nom de l'entreprise. Par exemple, XYZ Corp. Affichée dans le portail d'inscription sans contact des employés de l'entreprise. |
primary_emails |
Liste de object(string) |
Oui |
Sans contact:adresse e-mail des utilisateurs du client disposant du rôle de propriétaire. Au moins une adresse e-mail doit être saisie. Chaque adresse e-mail doit être associée à un compte Google. Les propriétaires partagent le même accès que les administrateurs, mais peuvent aussi ajouter, supprimer et modifier les utilisateurs du portail de votre entreprise.
Samsung:adresse e-mail du super-administrateur du client. Samsung n'utilise que le premier e-mail de la liste. L'adresse e-mail doit être associée à un compte Samsung. |
secondary_emails |
Liste de object(string) |
Non |
Adresse e-mail des utilisateurs du client disposant du rôle administrateur. Chaque adresse e-mail doit être associée à un compte Google. Remarque:Cette propriété n'est pas compatible avec Samsung. |
vendorParams |
map |
Sans contact:non
Samsung:oui |
Champs supplémentaires, paire clé-valeur spécifiée par le fournisseur. Les requêtes de la classe SamsungResellerService doivent spécifier les éléments suivants:
"country": code pays ISO 3166-1 du client, par exemple "US".
"firstName": prénom du client (60 caractères maximum).
"lastName": nom du client (60 caractères maximum).
"service": "KME" est la seule valeur acceptée. |
CreateCustomerResponse
| Nom de propriété |
Valeur |
Description |
customer |
object(Company) |
Objet contenant les informations du client nouvellement créé. |
vendor_params |
map |
Champs supplémentaires, paire clé-valeur spécifiée par le fournisseur (Samsung uniquement). |
Comportement en cas d'erreur
Si une erreur se produit, la bibliothèque génère une CommonException contenant l'un des codes d'erreur suivants:
CommonException
| Code d'erreur |
INTERNAL_SERVER_ERROR |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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` |"]]
