createCustomer

Tworzy Company jednoznacznie identyfikują firmę (klienta) w Knox lub usłudze Zero-Touch rejestracji. Po zwróceniu metody wskazani właściciele (primary_emails) lub administratorzy (secondary_emails) mogą powiązać swoje adresy e-mail z kontem konto umożliwiające dostęp do portalu Zero Touch; Szczegółowe informacje znajdziesz w artykule Rejestracja typu zero-touch dla administratorów IT. lub konto Samsung w celu uzyskania dostępu do portalu Knox Mobile Registration (KME).

Sygnatura metody

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

Nazwa usługi Wartość Wymagane Opis
customer_name string Tak Nazwa firmy. Na przykład XYZ Corp. wyświetlane pracownikom firmy w portalu rejestracji typu zero-touch.
primary_emails Lista wartości object(string) Tak Zero-touch: adresy e-mail użytkowników klienta z rolą właściciela. Wymagany jest co najmniej 1 adres e-mail. Każdy adres e-mail musi być powiązany z kontem Google. Właściciele mają takie same uprawnienia jak administratorzy, ale mogą też dodawać, usuwać i edytować użytkowników portalu organizacji.

Samsung: adres e-mail superadministratora klienta. Samsung wybiera tylko pierwszy adres e-mail na liście. Adres e-mail musi być powiązany z kontem Samsung.
secondary_emails Lista wartości object(string) Nie Adresy e-mail użytkowników klienta z rolą administratora. Każdy adres e-mail musi być powiązany z kontem Google. Uwaga: ta właściwość nie jest obsługiwana przez firmę Samsung.
vendorParams map Rejestracja typu zero-touch: nie

Samsung: tak
Dodatkowe pola, para klucz-wartość określona przez dostawcę. Żądania klasy SamsungResellerService muszą zawierać:

„country”: kod kraju w formacie ISO 3166-1, na przykład „US”.

„firstName”: imię klienta (maks. 60 znaków).

„lastName”: nazwisko klienta (maks. 60 znaków).

"service": "KME" to jedyna obsługiwana wartość.

CreateCustomerResponse

Nazwa usługi Wartość Opis
customer object(Company) Obiekt zawierający szczegółowe informacje o nowo utworzonym kliencie.
vendor_params map Dodatkowe pola, para klucz-wartość określona przez dostawcę (dotyczy tylko urządzeń Samsung).

Działanie błędu

Jeśli wystąpi błąd, biblioteka zgłasza CommonException, który zawiera jeden z te kody błędów:

CommonException

Kod błędu
INTERNAL_SERVER_ERROR