יצירת אובייקט Company לזיהוי חברה (לקוח) ייחודית ב-Knox או בהרשמה דרך הארגון. אחרי ששיטת האימות תוחזר בהצלחה, הבעלים שצוינו (primary_emails) או האדמינים (secondary_emails) יוכלו לשייך את כתובות האימייל שלהם לחשבון Google כדי לגשת לפורטל ההרשמה דרך הארגון (לפרטים, אפשר להיכנס אל הרשמה דרך אפס ל-IT) או לחשבון Samsung כדי לגשת לפורטל ההרשמה ל-Knox Mobile (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" הוא הערך היחיד הנתמך. |
יצירת תגובה ללקוחות
| שם הנכס | ערך | תיאור |
|---|---|---|
customer |
object(Company) |
אובייקט שמכיל פרטים על הלקוח החדש שנוצר. |
vendor_params |
map |
שדות נוספים, צמד מפתח/ערך שצוין על ידי הספק (Samsung בלבד). |
התנהגות השגיאה
אם מתרחשת שגיאה, בספרייה כתוב CommonException שמכיל את אחד מקודי השגיאה הבאים:
CommonException
| קוד שגיאה |
|---|
INTERNAL_SERVER_ERROR |