Knox veya sıfır dokunuşla kayıt için bir şirketi (müşteriyi) benzersiz şekilde tanımlamak üzere bir Company nesnesi oluşturur. Yöntem başarılı bir şekilde geri alındıktan sonra, belirtilen sahipler (primary_emails) veya yöneticiler (secondary_emails) e-posta adreslerini bir Google Hesabı ile ilişkilendirerek el değmeden kayıt portalına (ayrıntılar için bkz. BT yöneticileri için el değmeden kayıt sayfasına göz atın) veya Knox Mobile Enrollment (KME) portalına erişmek için bir Samsung Hesabı kullanabilir.
Yöntem imzası
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| Mülk adı | Değer | Zorunlu | Açıklama |
|---|---|---|---|
customer_name |
string |
Evet | Şirketin adı. Örneğin, XYZ A.Ş. Şirketin çalışanlarına el değmeden kayıt portalında gösterilir. |
primary_emails |
object(string) öğesinin listesi |
Evet | El değmeden: Müşterinin sahip rolündeki kullanıcılarının e-posta adresi. En az bir e-posta adresi gereklidir. Her e-posta adresi bir Google Hesabı ile ilişkilendirilmelidir. Sahipler, yöneticilerle aynı erişime sahiptir ancak kuruluşunuzun portal kullanıcılarını da ekleyebilir, silebilir ve düzenleyebilir. Samsung: Müşterinin süper yöneticisinin e-posta adresi. Samsung yalnızca listedeki ilk e-postayı alır. E-posta adresi bir Samsung Hesabı ile ilişkilendirilmiş olmalıdır. |
secondary_emails |
object(string) öğesinin listesi |
Hayır | Müşterinin yönetici rolündeki kullanıcılarının e-posta adresi. Her e-posta adresi bir Google Hesabı ile ilişkilendirilmelidir. Not: Bu özellik Samsung tarafından desteklenmez. |
vendorParams |
map |
El değmeden: Hayır Samsung: Evet |
Ek alanlar, tedarikçi firma tarafından belirtilen anahtar/değer çifti. SamsungResellerService sınıfından gelen istekler şunları belirtmelidir:"country": Müşterinin ISO 3166-1 ülke kodu (ör. "US"). "firstName": Müşterinin adı (en fazla 60 karakter). "lastName": Müşterinin soyadı (en fazla 60 karakter). "service": Yalnızca "KME" değeri desteklenir. |
CreateCustomerResponse
| Mülk adı | Değer | Açıklama |
|---|---|---|
customer |
object(Company) |
Yeni oluşturulan müşterinin ayrıntılarını içeren nesne. |
vendor_params |
map |
Ek alanlar, tedarikçi firma tarafından belirtilen anahtar/değer çifti (yalnızca Samsung). |
Hata davranışı
Hata oluştuğunda kitaplık aşağıdaki hata kodlarından birini içeren bir CommonException oluşturur:
CommonException
| Hata kodu |
|---|
INTERNAL_SERVER_ERROR |