Kunde erstellen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt ein Company-Objekt, um ein Unternehmen (Kunden) für die Knox- oder Zero-Touch-Registrierung eindeutig zu identifizieren. Nachdem die Methode erfolgreich zurückgegeben wurde, können die angegebenen Inhaber (primary_emails) oder Administratoren (secondary_emails) ihre E-Mail-Adressen mit einem Google-Konto verknüpfen, um auf das Zero-Touch-Kundenportal zuzugreifen (Zero-Touch-Registrierung für IT-Administratoren) oder mit einem Samsung-Konto, um auf das Knox Mobile Enrollment (KME)-Portal zuzugreifen.
Methodensignatur
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| Property-Name |
Wert |
Erforderlich |
Beschreibung |
customer_name |
string |
Ja |
Name des Unternehmens Beispiel: XYZ-AG. Wird den Mitarbeitern des Unternehmens im Zero-Touch-Registrierungsportal angezeigt. |
primary_emails |
Liste mit object(string) |
Ja |
Zero-Touch:E-Mail-Adresse des Kunden mit der Rolle „Inhaber“. Es muss mindestens eine E-Mail-Adresse eingegeben werden. Jede E-Mail-Adresse muss mit einem Google-Konto verknüpft sein. Inhaber haben denselben Zugriff wie Administratoren. Als Inhaber können sie aber auch die Nutzer des Portals Ihrer Organisation hinzufügen, löschen und bearbeiten.
Samsung:E-Mail-Adresse des Super Admins des Kunden. Samsung verwendet nur die erste E-Mail-Adresse in der Liste. Die E-Mail-Adresse muss mit einem Samsung-Konto verknüpft sein. |
secondary_emails |
Liste mit object(string) |
Nein |
E-Mail-Adresse der Nutzer des Kunden mit der Rolle „Administrator“. Jede E-Mail-Adresse muss mit einem Google-Konto verknüpft sein. Hinweis:Dieses Attribut wird von Samsung nicht unterstützt. |
vendorParams |
map |
Zero-Touch:Nein
Samsung:Ja |
Zusätzliche Felder, vom Anbieter angegebenes Schlüssel/Wert-Paar. Für Anfragen der Klasse SamsungResellerService müssen folgende Werte angegeben werden:
„country“: ISO 3166-1-Ländercode des Kunden, z. B. „US“.
„firstName“: Vorname des Kunden (max. 60 Zeichen).
„lastName“: Nachname des Kunden (max. 60 Zeichen).
„service“: „KME“ ist der einzige unterstützte Wert. |
CreateCustomerResponse
| Property-Name |
Wert |
Beschreibung |
customer |
object(Company) |
Objekt mit Details zum neu erstellten Kunden. |
vendor_params |
map |
Zusätzliche Felder, vom Anbieter angegebenes Schlüssel/Wert-Paar (nur Samsung). |
Fehlerverhalten
Wenn ein Fehler auftritt, gibt die Bibliothek einen CommonException mit einem der folgenden Fehlercodes zurück:
CommonException
| Fehlercode |
INTERNAL_SERVER_ERROR |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 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` |"]]
