REST Resource: customers.configurations

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

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

  • เครื่องมือควบคุมนโยบายด้านอุปกรณ์ (DPC) ของ 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/* โทรติดต่อ customers.dpcs.list เพื่อแสดง DPC ที่รองรับ

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

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