Knox veya el değmeden kayıt için bir şirketi (müşteri) benzersiz şekilde tanımlamak üzere bir Company nesnesi oluşturur. Yöntem başarıyla geri döndüğünde, belirtilen sahipler (primary_emails) veya yöneticiler (secondary_emails), el değmeden kayıt portalına erişmek için e-posta adreslerini bir Google Hesabı ile ilişkilendirebilir (ayrıntılar için BT yöneticileri için el değmeden kayıt bölümüne bakın) veya Knox Mobile Enrollment (KME) portalına erişmek için bir Samsung hesabı kullanabilirsiniz.
Yöntem imzası
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
Müşteri İsteği Oluştur
| Mülk adı | Değer | Zorunlu | Açıklama |
|---|---|---|---|
customer_name |
string |
Evet | Şirketin adı. Örneğin, XYZ Corp. şirketin el değmeden kayıt portalında çalışanlara gösteriliyor. |
primary_emails |
object(string) öğesinin listesi |
Evet | El değmeden kayıt: 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şimi paylaşır ancak aynı zamanda kuruluşunuzun portal kullanıcılarını ekleyebilir, silebilir ve düzenleyebilir. Samsung: Müşterinin süper yöneticisinin e-posta adresi. Samsung listedeki ilk e-postayı alır. E-posta adresi bir Samsung Hesabı ile ilişkilendirilmelidir. |
secondary_emails |
object(string) öğesinin listesi |
Hayır | Yönetici rolündeki müşteri kullanıcılarının e-posta adresi. Her e-posta adresi bir Google Hesabı ile ilişkilendirilmelidir. Not: Bu özellik Samsung tarafından desteklenmemektedir. |
vendorParams |
map |
El değmeden kayıt: Hayır Samsung: Evet |
Ek alanlar, satıcı tarafından belirtilen anahtar/değer çifti. SamsungResellerService sınıfından gelen istekler şu özelliklere sahip olmalıdır:"country": ISO 3166-1 ülke kodu (ör. "US"). "firstName": Müşterinin adı (maks. 60 karakter). "lastName": Müşterinin soyadı (maks. 60 karakter). "service": "KME", desteklenen tek değerdir. |
MüşteriMüşteri Yanıtı
| 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 |
Ekstra alanlar, satıcı tarafından belirtilen anahtar/değer çifti (yalnızca Samsung). |
Hata davranışı
Bir hata oluşursa kitaplık, aşağıdaki hata kodlarından birini içeren bir CommonException atar:
CommonException
| Hata kodu |
|---|
INTERNAL_SERVER_ERROR |