Utworzy obiekt Company, który jednoznacznie identyfikuje firmę (klienta) do rejestracji w Knox lub rejestracji typu zero-touch. Po przywróceniu metody niektórzy 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 Zero-Touch (więcej informacji znajdziesz w artykule Rejestracja typu zero-touch dla administratorów IT) lub na konto Samsung, aby uzyskać dostęp do portalu Knox Mobile Enrollment (KME).
Podpis metody
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
Utwórz żądanie klienta
| Nazwa usługi | Wartość | Wymagany | Opis |
|---|---|---|---|
customer_name |
string |
Tak | Nazwa firmy. Na przykład „XYZ Corp.” – wyświetlane w portalu rejestracji typu zero-touch. |
primary_emails |
Lista wartości object(string) |
Tak | Rejestracja typu 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ą te same uprawnienia dostępu co administratorzy, ale mogą dodawać, usuwać i edytować użytkowników portalu organizacji. Samsung: adres e-mail superadministratora klienta. Samsung bierze tylko pod uwagę pierwszy e-mail na liście. Adres e-mail musi być powiązany z kontem Samsung. |
secondary_emails |
Lista wartości object(string) |
Nie | Adres e-mail użytkowników klienta pełniącego rolę administratora. Każdy adres e-mail musi być powiązany z kontem Google. Uwaga: ta właściwość nie jest obsługiwana przez Samsunga. |
vendorParams |
map |
Zero-Touch: Nie Samsung: tak |
Dodatkowe pola określone przez dostawcę w parze klucz-wartość. Żądania z klasy SamsungResellerService muszą zawierać:"country": kod kraju w formacie ISO 3166-1 klienta, 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óły nowo utworzonego klienta. |
vendor_params |
map |
Dodatkowe pola określone przez dostawcę pary klucz-wartość (tylko Samsung). |
Działanie błędu
Jeśli wystąpi błąd, biblioteka wyświetli CommonException zawierający jeden z tych kodów błędów:
CommonException
| Kod błędu |
|---|
INTERNAL_SERVER_ERROR |