יצירה של לקוח

ייווצר Company אובייקט לזיהוי ייחודי של חברה (לקוח) ב-Knox או דרך הארגון להרשמה לקראת השקת אפליקציה. אחרי שהשיטה תחזיר נתונים, הבעלים (primary_emails) או האדמינים (secondary_emails) שצוינו יוכלו לשייך את כתובות האימייל שלהם לחשבון Google כדי לגשת לפורטל ההרשמה ללא מגע (פרטים נוספים זמינים במאמר הרשמה ללא מגע לאדמינים ב-IT) או לחשבון Samsung כדי לגשת לפורטל Knox Mobile Enrollment‏ (KME).

חתימה של method

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