Kunde erstellen

Erstellt ein Company-Objekt, um ein Unternehmen (Kunde) 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 Portal für die Zero-Touch-Registrierung oder auf ein Samsung-Konto zuzugreifen, um auf das Portal der Knox Mobile Enrollment (KME) zuzugreifen.

Methodensignatur

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

Attributname Wert Erforderlich Beschreibung
customer_name string Ja Der Name des Unternehmens. Beispiel: XYZ Corp. wird den Mitarbeitern des Unternehmens im Portal für die Zero-Touch-Registrierung angezeigt.
primary_emails Liste von object(string) Ja Zero-Touch: E-Mail-Adresse der Nutzer des Kunden in der Inhaberrolle 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, können aber auch Portalnutzer Ihrer Organisation hinzufügen, löschen und bearbeiten.

Samsung:E-Mail-Adresse des Super Admins des Kunden. Samsung nimmt nur die erste E-Mail in der Liste an. Die E-Mail-Adresse muss mit einem Samsung-Konto verknüpft sein.
secondary_emails Liste von object(string) Nein E-Mail-Adresse der Nutzer des Kunden mit der Administratorrolle. Jede E-Mail-Adresse muss mit einem Google-Konto verknüpft sein. Hinweis: Diese Property 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 von der Klasse SamsungResellerService muss Folgendes 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.

CustomerCustomerResponse erstellen

Attributname Wert Beschreibung
customer object(Company) Objekt, das Details zum neu erstellten Kunden enthält.
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 aus, der einen der folgenden Fehlercodes enthält:

CommonException

Fehlercode
INTERNAL_SERVER_ERROR