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 |