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 |