יצירת אובייקט Company כדי לזהות באופן ייחודי חברה (לקוח) עבור Knox או הרשמה ללא מגע. אחרי שהשיטה תחזיר נתונים, הבעלים (primary_emails) או האדמינים (secondary_emails) שצוינו יוכלו לשייך את כתובות האימייל שלהם לחשבון Google כדי לגשת לפורטל ההרשמה ללא מגע (פרטים נוספים זמינים במאמר הרשמה ללא מגע לאדמינים ב-IT) או לחשבון Samsung כדי לגשת לפורטל Knox Mobile Enrollment (KME).
חתימת שיטה
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
| שם הנכס | ערך | חובה | תיאור |
|---|---|---|---|
customer_name |
string |
כן | שם החברה. לדוגמה, XYZ Corp. מוצג לעובדים של החברה בפורטל ההרשמה ללא מגע. |
primary_emails |
רשימה של object(string) |
כן | ללא מגע: כתובת האימייל של המשתמשים של הלקוח בתפקיד 'בעלים'. צריך להזין לפחות כתובת אימייל אחת. כל כתובת אימייל צריכה להיות משויכת לחשבון Google. לבעלים יש את אותה גישה שיש לאדמינים, אבל הם יכולים גם להוסיף, למחוק ולערוך את המשתמשים בפורטל של הארגון. Samsung: כתובת האימייל של הסופר-אדמין של הלקוח. Samsung משתמשת רק בכתובת האימייל הראשונה ברשימה. כתובת האימייל צריכה להיות משויכת לחשבון Samsung. |
secondary_emails |
רשימה של object(string) |
לא | כתובת האימייל של המשתמשים של הלקוח בתפקיד אדמין. כל כתובת אימייל צריכה להיות משויכת לחשבון Google. הערה: Samsung לא תומכת במאפיין הזה. |
vendorParams |
map |
דרך הארגון: לא Samsung: כן |
שדות נוספים, צמד מפתח/ערך שצוין על ידי הספק. בבקשות מהקלאס SamsungResellerService צריך לציין:"country": קוד המדינה לפי תקן ISO 3166-1 של הלקוח, לדוגמה 'US'. "firstName": השם הפרטי של הלקוח (עד 60 תווים). "lastName": שם המשפחה של הלקוח (עד 60 תווים). "service": הערך היחיד שנתמך הוא 'KME'. |
CreateCustomerResponse
| שם הנכס | ערך | תיאור |
|---|---|---|
customer |
object(Company) |
אובייקט שמכיל פרטים של הלקוח החדש שנוצר. |
vendor_params |
map |
שדות נוספים, צמד מפתח/ערך שצוין על ידי הספק (Samsung בלבד). |
התנהגות במקרה של שגיאה
אם מתרחשת שגיאה, הספרייה גורמת להשלכה של CommonException שמכיל אחד מקודי השגיאה הבאים:
CommonException
| קוד שגיאה |
|---|
INTERNAL_SERVER_ERROR |