Users

ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้

การนำเสนอแหล่งข้อมูล

ทรัพยากรผู้ใช้แสดงถึงบัญชีที่เชื่อมโยงกับองค์กร โดยบัญชีอาจเจาะจงเฉพาะอุปกรณ์หรือผู้ใช้แต่ละคน (ซึ่งใช้บัญชีดังกล่าวในอุปกรณ์หลายเครื่องได้) บัญชีอาจให้สิทธิ์เข้าถึง Managed Google Play เท่านั้น หรือบริการอื่นๆ ของ Google โดยขึ้นอยู่กับโมเดลข้อมูลประจำตัว ดังนี้

  • โมเดลข้อมูลประจำตัวของโดเมนที่มีการจัดการของ Google กำหนดให้ซิงค์กับแหล่งที่มาของบัญชี Google (ผ่าน primaryEmail)
  • โมเดลข้อมูลประจำตัวของบัญชี Managed Google Play มอบวิธีการแบบไดนามิกสำหรับองค์กรในการสร้างบัญชีผู้ใช้หรืออุปกรณ์ของผู้ใช้ตามความจำเป็น บัญชีเหล่านี้ให้สิทธิ์เข้าถึง Managed Google Play

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
accountIdentifier string ตัวระบุที่ไม่ซ้ำกันซึ่งคุณสร้างให้ผู้ใช้รายนี้ เช่น "user342" หรือ "asset#44418" อย่าใช้ข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) สำหรับพร็อพเพอร์ตี้นี้ ต้องตั้งค่าสำหรับผู้ใช้ที่จัดการโดย EMM เสมอ ไม่ได้ตั้งค่าให้กับผู้ใช้ที่จัดการโดย Google
accountType string ประเภทของบัญชีที่ผู้ใช้รายนี้เป็นตัวแทน userAccount สามารถติดตั้งได้ในอุปกรณ์หลายเครื่อง แต่ deviceAccount จะใช้กับอุปกรณ์เครื่องเดียวโดยเฉพาะ ผู้ใช้ที่จัดการโดย EMM (emmManaged) อาจเป็นประเภทใดก็ได้ (userAccount, deviceAccount) แต่ผู้ใช้ที่จัดการโดย Google (googleManaged) จะเป็น userAccount เสมอ

ค่าที่ยอมรับได้ มีดังนี้
  • "deviceAccount"
  • "userAccount"
displayName string ชื่อที่จะปรากฏในอินเทอร์เฟซผู้ใช้ การตั้งค่านี้เป็นตัวเลือกเมื่อสร้างผู้ใช้ที่จัดการโดย EMM หากคุณตั้งค่าพร็อพเพอร์ตี้นี้ไว้ โปรดใช้ชื่อทั่วไปเกี่ยวกับองค์กร (เช่น "Example, Inc.") หรือชื่อของคุณ (เป็น EMM) ไม่ใช้สำหรับบัญชีผู้ใช้ที่จัดการโดย Google เขียนได้
id string รหัสที่ไม่ซ้ำกันสำหรับผู้ใช้

kind string
managementType string เอนทิตีที่จัดการผู้ใช้ เมื่อใช้ผู้ใช้ googleManaged แหล่งข้อมูลที่ถูกต้องคือ Google ดังนั้น EMM จึงต้องตรวจสอบว่าผู้ใช้ดังกล่าวมีบัญชี Google อยู่ หากมีผู้ใช้ emmManaged คน EMM จะเป็นผู้ดูแลจัดการ

ค่าที่ยอมรับได้ มีดังนี้
  • "emmManaged"
  • "googleManaged"
primaryEmail string อีเมลหลักของผู้ใช้ เช่น "jsmith@example.com" ระบบจะตั้งค่าสำหรับผู้ใช้ที่มีการจัดการโดย Google เสมอ และไม่ตั้งค่าไว้สำหรับผู้ใช้ที่มีการจัดการด้วย EMM

เมธอด

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

คุณจะจัดสรรอุปกรณ์ได้สูงสุด 10 เครื่องต่อผู้ใช้

การโทรนี้ใช้ได้กับบัญชีที่จัดการโดย EMM เท่านั้น
รับ
เรียกข้อมูลรายละเอียดของผู้ใช้
getAvailableProductSet
เรียกข้อมูลชุดผลิตภัณฑ์ที่ผู้ใช้มีสิทธิ์เข้าถึง
แทรก
สร้างผู้ใช้ที่จัดการโดย EMM ใหม่

ทรัพยากรของผู้ใช้ ที่ส่งมาในเนื้อหาของคำขอควรมี accountIdentifier และ accountType

หากมีผู้ใช้ที่ตรงกันซึ่งมีตัวระบุบัญชีเดียวกันอยู่แล้ว ผู้ใช้จะได้รับการอัปเดตด้วยทรัพยากร ในกรณีนี้ จะมีเพียงฟังก์ชัน เปลี่ยนช่อง displayName ได้

list
ค้นหาผู้ใช้ตามอีเมลหลัก การดำเนินการนี้รองรับเฉพาะผู้ใช้ที่จัดการโดย Google ค้นหารหัสไม่ถูกต้อง ที่จำเป็นสำหรับผู้ใช้ที่มีการจัดการด้วย EMM เพราะมีการส่งคืนรหัสใน ผลของการเรียก Users.insert
revokeDeviceAccess
เพิกถอนสิทธิ์เข้าถึงอุปกรณ์ทั้งหมดที่จัดสรรให้กับผู้ใช้ในปัจจุบัน ผู้ใช้ จะไม่สามารถใช้ Managed Play Store ในบัญชี อุปกรณ์ที่มีการจัดการ

การโทรนี้ใช้ได้กับบัญชีที่จัดการโดย EMM เท่านั้น
setAvailableProductSet
แก้ไขชุดผลิตภัณฑ์ที่ผู้ใช้มีสิทธิ์เข้าถึง (ซึ่งเรียกว่า เป็นผลิตภัณฑ์ที่ได้รับอนุญาต) เฉพาะผลิตภัณฑ์ที่ อนุมัติแล้ว หรือผลิตภัณฑ์ที่ได้รับอนุมัติก่อนหน้านี้ (ผลิตภัณฑ์ที่ถูกยกเลิกการอนุมัติ) ได้รับอนุญาตพิเศษได้
อัปเดต
อัปเดตรายละเอียดผู้ใช้ที่จัดการโดย EMM

ใช้ได้กับผู้ใช้ที่จัดการโดย EMM เท่านั้น (ไม่ใช่ผู้ใช้ที่จัดการโดย Google) ส่งรายละเอียดใหม่ใน ผู้ใช้ ในเนื้อหาคำขอ เฉพาะช่อง displayName เปลี่ยนแปลงได้ ต้องไม่ได้ตั้งค่าในช่องอื่นๆ หรือมีแอตทริบิวต์ ค่าที่ใช้งานอยู่ในปัจจุบัน