REST Resource: customers.configurations

משאב: הגדרה

מערך הגדרות אישיות אוסף את האפשרויות של ניהול התצורה במכשירי Android. כל הגדרה אישית משלבת את הדברים הבאים:

  • בקר מדיניות מכשיר ה-EMM (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/*. כדי לראות את רשימת בקרי ה-DPC הנתמכים, צריך להתקשר אל customers.dpcs.list.
dpcExtras

string

התוספות להקצאת EMM בפורמט 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

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