יצירה של לקוח

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