REST Resource: customers.configurations

משאב: תצורה

תצורה אוספת את אפשרויות ההקצאה של מכשירי Android. כל תצורה משלבת את הפרטים הבאים:

  • בקר המדיניות לניהול הניידות בארגון (DPC) שמותקן במכשירים.
  • כללי מדיניות EMM נאכפים במכשירים.
  • מטא-נתונים שמוצגים במכשיר כדי לעזור למשתמשים במהלך ההגדרה.

לקוחות יכולים להוסיף כמה הגדרות שהם רוצים. עם זאת, התכונה 'הרשמה דרך הארגון' פועלת בצורה הטובה ביותר כשלקוח מגדיר תצורת ברירת מחדל שחלה על כל מכשיר חדש שהארגון קונה.

ייצוג JSON 
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
שדות
name

string

פלט בלבד. שם המשאב של ה-API בפורמט customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. הוקצה על ידי השרת.
configurationId

string (int64 format)

פלט בלבד. מזהה ההגדרה. הוקצה על ידי השרת.
configurationName

string

חובה. שם קצר שמתאר את מטרת התצורה. לדוגמה, צוות המכירות או עובדים זמניים. פורטל ההרשמה דרך הארגון מציג את השם הזה בפני מנהלי ה-IT.
dpcResourcePath

string

חובה. שם המשאב של ה-DPC שנבחר (נאמן המדיניות של המכשיר) בפורמט customers/[CUSTOMER_ID]/dpcs/*. כדי ליצור רשימה של ה-DPCs הנתמכים, יש להתקשר למספר customers.dpcs.list.
dpcExtras

string

תוספות ניהול התצורה של ניהול הניידות בארגון, המבוססות על פורמט JSON, שמועברות ל-DPC.
companyName

string

חובה. שם הארגון הרשמה דרך הארגון מציגה את שם הארגון הזה למשתמשים במכשירים במהלך הקצאת המכשיר.
contactEmail

string

חובה. כתובת האימייל שדרכה משתמשים יכולים לפנות לקבלת עזרה. הרשמה דרך הארגון מציגה את כתובת האימייל הזו למשתמשי המכשיר לפני הקצאת המכשיר לארגון. הערך מאומת עם קלט.
contactPhone

string

חובה. מספר הטלפון שמשתמשים יכולים להתקשר אליו דרך מכשיר אחר כדי לקבל עזרה. הרשמה דרך הארגון מציגה את המספר הזה למשתמשים במכשיר לפני ההקצאה של המכשיר. מקבלים ספרות, רווחים, סימן חיבור, מקפים וסוגריים.
customMessage

string

הודעה שכוללת משפט אחד או שניים המסייעת למשתמשים לקבל עזרה או למסור להם פרטים נוספים על מה שקורה במכשיר שלהם. הרשמה דרך הארגון מציגה את ההודעה הזו לפני הקצאת המכשיר.
isDefault

boolean

חובה. אם זו תצורת ברירת המחדל שהרשמה דרך הארגון חלה על כל המכשירים החדשים שהארגון ירכוש בעתיד. ניתן להגדיר רק תצורה אחת של לקוח. אם ההגדרה הזו מקבלת את הערך true, הערך isDefault של תצורת ברירת המחדל הקודמת משתנה ל-false.
forcedResetTime

string (Duration format)

אופציונלי. הזמן הקצוב לתפוגה לפני אילוץ איפוס המכשיר להגדרות המקוריות אם המכשיר לא עבר את ניהול התצורה באשף ההגדרה, בדרך כלל בגלל היעדר קישוריות לרשת במהלך אשף ההגדרה. נע בין 0 ל-6 שעות, כשברירת המחדל היא שעתיים.

משך זמן בשניות עם עד תשע ספרות עשרוניות, עם סיומת 's'. דוגמה: "3.5s".

שיטות

create

 יצירת תצורה חדשה.

delete

 מחיקת הגדרה שלא בשימוש.

get

 הצגת הפרטים של ההגדרה.

list

 מפרט את ההגדרות האישיות של לקוח.

patch

 עדכון ערכי השדה של תצורה.