REST Resource: customers.configurations

ทรัพยากร: การกําหนดค่า

การกําหนดค่าจะรวบรวมตัวเลือกการจัดสรรสําหรับอุปกรณ์ Android ซึ่งการกำหนดค่าแต่ละแบบจะประกอบด้วยรายการต่อไปนี้

  • ตัวควบคุมนโยบายด้านอุปกรณ์ (EMM) ของอุปกรณ์ EMM ที่ติดตั้งในอุปกรณ์
  • บังคับใช้นโยบาย 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

ต้องระบุ ชื่อย่อที่อธิบายวัตถุประสงค์ของการกําหนดค่า เช่น ทีมขายหรือพนักงานชั่วคราว พอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มจะแสดงชื่อนี้แก่ผู้ดูแลระบบไอที
dpcResourcePath

string

ต้องระบุ ชื่อทรัพยากรของ DPC ที่เลือก (ตัวควบคุมนโยบายด้านอุปกรณ์) ในรูปแบบ customers/[CUSTOMER_ID]/dpcs/* หากต้องการโทรหา DPC ที่รองรับ ให้ติดต่อ customers.dpcs.list
dpcExtras

string

ส่วนขยาย EMM ในรูปแบบ JSON ที่ส่งผ่านไปยัง DPC
companyName

string

ต้องระบุ ชื่อขององค์กร การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มจะแสดงชื่อองค์กรนี้ต่อผู้ใช้อุปกรณ์ในระหว่างการจัดเตรียมอุปกรณ์
contactEmail

string

ต้องระบุ อีเมลที่ผู้ใช้อุปกรณ์ใช้ติดต่อเพื่อขอความช่วยเหลือได้ ซึ่งการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มจะแสดงที่อยู่อีเมลนี้ต่อผู้ใช้อุปกรณ์ก่อนการจัดเตรียมอุปกรณ์ ค่านี้ได้รับการตรวจสอบเมื่อป้อนข้อมูล
contactPhone

string

ต้องระบุ หมายเลขโทรศัพท์ที่ผู้ใช้อุปกรณ์โทรหาได้ โดยใช้อุปกรณ์อื่นเพื่อขอความช่วยเหลือ การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มจะแสดงหมายเลขนี้ต่อผู้ใช้อุปกรณ์ก่อนการจัดเตรียมอุปกรณ์ ยอมรับตัวเลข ช่องว่าง เครื่องหมายบวก ขีดกลาง และวงเล็บ
customMessage

string

ข้อความที่มี 1 หรือ 2 ประโยคเพื่อช่วยให้ผู้ใช้อุปกรณ์ได้รับความช่วยเหลือหรือให้รายละเอียดเพิ่มเติมเกี่ยวกับสิ่งที่เกิดขึ้นกับอุปกรณ์ การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม จะแสดงข้อความนี้ก่อนจัดสรรอุปกรณ์
isDefault

boolean

ต้องระบุ การกําหนดค่านี้เป็นค่าเริ่มต้นที่การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มมีผลกับอุปกรณ์ใหม่ที่องค์กรซื้อในอนาคตหรือไม่ ใช้การกําหนดค่าลูกค้าได้เพียง 1 รายการเท่านั้นโดยค่าเริ่มต้น เมื่อกําหนดค่านี้เป็น true จะเปลี่ยนค่า isDefault ของการกําหนดค่าเริ่มต้นก่อนหน้าเป็น false
forcedResetTime

string (Duration format)

ไม่บังคับ ระยะหมดเวลาก่อนการบังคับให้รีเซ็ตอุปกรณ์เป็นค่าเริ่มต้นจากโรงงาน ถ้าอุปกรณ์นั้นไม่ผ่านการจัดสรรในวิซาร์ดการตั้งค่า มักเกิดจากการขาดการเชื่อมต่อเครือข่ายระหว่างวิซาร์ดการตั้งค่า ค่าอยู่ในช่วง 0-6 ชั่วโมง โดย 2 ชั่วโมงคือค่าเริ่มต้น หากไม่ได้ตั้งค่า

ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก และลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

วิธีการ

create

 สร้างการกําหนดค่าใหม่

delete

 ลบการกําหนดค่าที่ไม่ได้ใช้

get

 รับรายละเอียดของการกําหนดค่า

list

 แสดงรายการการกําหนดค่าของลูกค้า

patch

 อัปเดตค่าของช่องการกําหนดค่า