createCustomer

Tworzy obiekt Company, aby jednoznacznie identyfikować firmę (klienta) na potrzeby rejestracji w Knox lub rejestracji typu zero-touch. Po pomyślnym wywołaniu metody wskazani właściciele (primary_emails) lub administratorzy (secondary_emails) mogą powiązać swoje adresy e-mail z kontem Google, aby uzyskać dostęp do portalu rejestracji typu zero-touch (szczegóły znajdziesz w artykule Rejestracja typu zero-touch dla administratorów IT), lub z kontem Samsung, aby uzyskać dostęp do portalu Knox Mobile Enrollment (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świetlany pracownikom firmy w portalu rejestracji typu zero-touch.
primary_emails Lista wartości object(string) Tak Zero-touch: adres 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 dostępu jak administratorzy, ale mogą też dodawać, usuwać i edytować użytkowników portalu organizacji.

Samsung: adres e-mail super administratora 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, pary klucz-wartość określone przez dostawcę. Żądania z klasy SamsungResellerService muszą zawierać te informacje:

„country”: kod ISO 3166-1 kraju klienta, np. „US”.

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

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

„service”: jedyną obsługiwaną wartością jest „KME”.

CreateCustomerResponse

Nazwa usługi Wartość Opis
customer object(Company) Obiekt zawierający szczegóły nowo utworzonego klienta.
vendor_params map Dodatkowe pola, para klucz-wartość określona przez dostawcę (dotyczy tylko Samsunga).

Zachowanie w przypadku błędu

Jeśli wystąpi błąd, biblioteka zwróci błąd CommonException zawierający jeden z tych kodów błędu:

CommonException

Kod błędu
INTERNAL_SERVER_ERROR